ST_Raster.describe
Definition
ST_Raster.describe stellt die Eigenschaftenliste eines ST_Raster-Objekts zur Verfügung. Zu den optionalen Eingabeparametern gehören entweder "storage", wodurch die "describe"-Funktion angewiesen wird, die Speichergröße der einzelnen Bändern nach Pyramidenebene anzuzeigen, oder "color map", was darauf hinweist, dass mit der "describe"-Funktion der Colormap-Index aufgelistet werden soll, falls vorhanden. Die "describe"-Funktion ist allein zur Verwendung als Teil der Auswahlliste einer SQL-SELECT-Anweisung ausgelegt.
Syntax
Oracle
describe () RETURN CLOB describe (parameter IN VARCHAR2) RETURN CLOB
PostgreSQL
describe (raster IN ST_RASTER) RETURN TEXT describe (raster IN ST_RASTER, parameter IN TEXT) RETURN TEXT
SQL Server
describe (parameter IN NVARCHAR) RETURN NVARCHAR
Rückgaben
CLOB
Parameter
Wenn kein Parameter angegeben wird, werden mit der "describe"-Funktion grundlegende Eigenschaften des ST_Raster-Objekts angezeigt.
Parameter | Beschreibung |
---|---|
Speicherung | Weist die "describe"-Funktion an, den tatsächlichen komprimierten Speicherversatz für die einzelnen Bänder und Pyramidenebenen des Colormap-ST_Raster-Objekts aufzulisten. |
Colormap | Weist die "describe"-Funktion an, den Colormap-Index des Colormap-ST_Raster-Objekts aufzulisten. |
Beispiele
In diesen Beispielen wird Folgendes veranschaulicht:
- Das erste Beispiel ist eine SELECT-Anweisung und stellt eine Liste mit ST_Raster-Eigenschaften aus der Funktion "ST_Raster.describe()" bereit.
- Im nächsten Beispiel wird die Verwendung des "storage"-Parameters mit der Funktion "ST_Raster.describe()" veranschaulicht.
- Im letzten Beispiel wird gezeigt, wie die Raster-Colormap-Informationen zurückgegeben werden.
Oracle
-
SELECT n.image.describe() FROM NOVA n; Raster ID ...................: 2 Raster Column ID ............: 268 Raster Dimension ............: 6000, 6000, 1 Raster Tile Dimension .......: 128, 128 Pixel Type ..................: int16 Compression .................: lz77 Image Pyramid ...............: 6, bilinear Extent ......................: <NONE> Statistics ..................: min : 4271.0000000000 max : 6751.0000000000 mean : 5024.6673817222 std dev : 272.5172958117
-
SELECT n.image.describe('storage') FROM NOVA n; Raster Tile Storage .........: min max mean std dev count total Level 0: Band 1 61 23802 16818.32 3681.83 2209 36,281 KB Level 1: Band 1 2506 24028 17958.37 3836.54 576 10,102 KB Level 2: Band 1 6786 23245 19566.38 2732.57 144 2,752 KB Level 3: Band 1 16547 23232 20919.81 1736.37 36 735 KB Level 4: Band 1 19764 23620 21993.11 1271.31 9 193 KB Level 5: Band 1 5854 23853 13186.50 7596.00 4 52 KB Level 6: Band 1 13563 13563 13563.00 0.00 1 13 KB 50,128 KB 51,330,596 bytes Compression Ratio ...........: 1.40267
-
SELECT n.image.describe('colormap') FROM NOVA n WHERE n.image.raster_id = 1; Raster ID ...................: 1 Raster Column ID ............: 329 Raster Dimension ............: 512, 512, 1 Raster Tile Dimension .......: 128, 128 Pixel Type ..................: uint8 Compression .................: lz77 Image Pyramid ...............: <NONE> Extent ......................: <NONE> Colormap ....................: rgb, uint16, 256 index red green blue 0 14906 0 0 1 8738 0 0 2 5654 0 0 3 2570 0 0 4 27242 23901 31868 5 51143 50886 51400 6 19018 13878 23644 7 6168 2056 6168 8 55512 51400 55512 9 63736 59624 63736 10 60138 55512 59624 ... ... ... ... 250 63736 63736 63736 251 59624 59624 59624 252 55512 55512 55512 253 6168 6168 6168 254 2056 2056 2056 255 65535 65535 65535
PostgreSQL
-
SELECT describe(image) FROM nova; Raster ID ...................: 2 Raster Column ID ............: 268 Raster Dimension ............: 6000, 6000, 1 Raster Tile Dimension .......: 128, 128 Pixel Type ..................: int16 Compression .................: lz77 Image Pyramid ...............: 6, bilinear Extent ......................: <NONE> Statistics ..................: min : 4271.0000000000 max : 6751.0000000000 mean : 5024.6673817222 std dev : 272.5172958117
-
SELECT describe(image,'storage') FROM nova; Raster Tile Storage .........: min max mean std dev count total Level 0: Band 1 61 23802 16818.32 3681.83 2209 36,281 KB Level 1: Band 1 2506 24028 17958.37 3836.54 576 10,102 KB Level 2: Band 1 6786 23245 19566.38 2732.57 144 2,752 KB Level 3: Band 1 16547 23232 20919.81 1736.37 36 735 KB Level 4: Band 1 19764 23620 21993.11 1271.31 9 193 KB Level 5: Band 1 5854 23853 13186.50 7596.00 4 52 KB Level 6: Band 1 13563 13563 13563.00 0.00 1 13 KB 50,128 KB 51,330,596 bytes Compression Ratio ...........: 1.40267
-
SELECT describe(image,'colormap') FROM nova WHERE image.raster_id = 1; Raster ID ...................: 1 Raster Column ID ............: 329 Raster Dimension ............: 512, 512, 1 Raster Tile Dimension .......: 128, 128 Pixel Type ..................: uint8 Compression .................: lz77 Image Pyramid ...............: <NONE> Extent ......................: <NONE> Colormap ....................: rgb, uint16, 256 index red green blue 0 14906 0 0 1 8738 0 0 2 5654 0 0 3 2570 0 0 4 27242 23901 31868 5 51143 50886 51400 6 19018 13878 23644 7 6168 2056 6168 8 55512 51400 55512 9 63736 59624 63736 10 60138 55512 59624 ... ... ... ... 250 63736 63736 63736 251 59624 59624 59624 252 55512 55512 55512 253 6168 6168 6168 254 2056 2056 2056 255 65535 65535 65535
SQL Server
-
SELECT image.describe(NULL) FROM nova; Raster ID ...................: 2 Raster Column ID ............: 268 Raster Dimension ............: 6000, 6000, 1 Raster Tile Dimension .......: 128, 128 Pixel Type ..................: int16 Compression .................: lz77 Image Pyramid ...............: 6, bilinear Extent ......................: <NONE> Statistics ..................: min : 4271.0000000000 max : 6751.0000000000 mean : 5024.6673817222 std dev : 272.5172958117
-
SELECT image.describe('storage') FROM nova; Raster Tile Storage .........: min max mean std dev count total Level 0: Band 1 61 23802 16818.32 3681.83 2209 36,281 KB Level 1: Band 1 2506 24028 17958.37 3836.54 576 10,102 KB Level 2: Band 1 6786 23245 19566.38 2732.57 144 2,752 KB Level 3: Band 1 16547 23232 20919.81 1736.37 36 735 KB Level 4: Band 1 19764 23620 21993.11 1271.31 9 193 KB Level 5: Band 1 5854 23853 13186.50 7596.00 4 52 KB Level 6: Band 1 13563 13563 13563.00 0.00 1 13 KB 50,128 KB 51,330,596 bytes Compression Ratio ...........: 1.40267
-
SELECT image.describe('colormap') FROM nova WHERE image.raster_id = 1; Raster ID ...................: 1 Raster Column ID ............: 329 Raster Dimension ............: 512, 512, 1 Raster Tile Dimension .......: 128, 128 Pixel Type ..................: uint8 Compression .................: lz77 Image Pyramid ...............: <NONE> Extent ......................: <NONE> Colormap ....................: rgb, uint16, 256 index red green blue 0 14906 0 0 1 8738 0 0 2 5654 0 0 3 2570 0 0 4 27242 23901 31868 5 51143 50886 51400 6 19018 13878 23644 7 6168 2056 6168 8 55512 51400 55512 9 63736 59624 63736 10 60138 55512 59624 ... ... ... ... 250 63736 63736 63736 251 59624 59624 59624 252 55512 55512 55512 253 6168 6168 6168 254 2056 2056 2056 255 65535 65535 65535