Определение
ST_Raster.describe предоставляет список свойств объекта ST_Raster. Необязательные входные параметры включают или storage (хранение), который предписывает функции describe отображать размер памяти для каждого канала по уровню пирамидных слоев, или color map (цветовая карта), который показывает, что функция describe должна показывать список индексов цветовой карты, если существует хотя бы один индекс. Функция describe была разработана для использования исключительно как часть списка выборки выражения SELECT в SQL.
Синтаксис
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
Возвраты
CLOB
Параметры
Если параметр не задан, функция describe отображает основные свойства данного объекта ST_Raster.
Параметр | Описание |
---|---|
хранение | Предписывает функции describe перечислить текущее отклонение сжатой памяти (compressed storage displacement) для каждого канала и уровень пирамидных слоев в цветовой карте объекта ST_Raster |
colormap | Предписывает функции describe перечислить индексы цветовой карты для объекта ST_Raster с цветовой кодировкой |
Примеры
Эти примеры демонстрируют следующее:
- Первым примером является выражение SELECT, которое предоставляет список свойств ST_Raster из функции ST_Raster.describe().
- Следующий пример иллюстрирует использование параметра storage в функции ST_Raster.describe().
- Последний пример показывает, как получить информацию о цветовой карте растра.
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