ST_Raster.export

Определение

Функция ST_Raster.export записывает весь объект ST_Raster или его часть в файл изображения. Данная функция была разработана для использования только как часть списка выборки выражения SELECT в SQL.

Синтаксис

Oracle

export (filename IN VARCHAR2) RETURN VARCHAR2

export (filename IN VARCHAR2, 
        parameter_list IN VARCHAR2) RETURN VARCHAR2

PostgreSQL

export (raster IN ST_RASTER, 
        filename IN TEXT) RETURN TEXT

export (raster IN ST_RASTER, 
        filename IN TEXT, 
        parameter_list IN TEXT) RETURN TEXT

SQL Server

export (filename IN NVARCHAR, 
        parameter_list IN NVARCHAR) RETURN NVARCHAR

Возвраты

VARCHAR

Параметры

Параметры	Описания
имя файла	Имя файла экспортируемого растра Параметр имени файла имеет формат VARCHAR, поэтому он должен быть заключен в одинарные кавычки. Расширение имени файла определяет формат растра, который будет использован для экспорта файла. В настоящий момент поддерживаемым форматом растра для экспорта является GeoTIFF. Поэтому необходимо ввести расширение .tif.
растр	Значение ST_Raster, которое будет экспортировано
parameter_list	Список параметров с разделителем запятая, заключенный в одиночные кавычки, который может включать следующее: band <1st band number>[,<2nd band number>],…,[nth band number]>—Список порядковых номеров канала для тех каналов, которые будут экспортированы, с разделителем запятая Данные пикселов экспортируются в том порядке, в каком идут порядковые номера канала. Если этот параметр не определен, все каналы экспортируются в обычном последовательном порядке канала. level <pyramid level>—Уровень пирамидного слоя объекта ST_Raster, который будет экспортирован; значением по умолчанию является базовый уровень (0). compression <lzw | g3 | g4 | zip>—Сжатие, используемое для создания файла изображения; значением по умолчанию является создание файла изображения без сжатия. window (minx,miny,maxx,maxy)—Экстент для объекта ST_Raster, экспортируемого в файл изображения, заданный в координатах пикселов extent (minx,miny,maxx,maxy)—Экстент для объекта ST_Raster, экспортируемого в файл изображения, заданный в географических координатах overwrite—Если файл уже существует, то он будет перезаписан. Поведение по умолчанию - возвращает ошибку, если такой файл уже существует.

Примеры

Эти примеры демонстрируют следующее:

1. Как экспортировать объект ST_Raster в файл GeoTIFF с названием border.tif
2. Как экспортировать второй уровень пирамидного слоя объекта ST_Raster object, файл GeoTIFF, и pyramid.tif, в убывающем последовательном порядке каналов

В этих примерах файлы экспортируются в то местоположение на сервере СУБД, где обрабатывается SQL. Вы можете включить конкретный путь с собственным названием файла. Убедитесь в корректности пути для сервера СУБД (DBMS).

Oracle

1. SELECT image.export('border.tif', 'compression=zip') 
     FROM BORDER t
     WHERE t.image.raster_id = 10;
   

2. SELECT image.export('pyramid.tif', 'level=2, band=(3,2,1)')
     FROM BORDER
     WHERE image.raster_id = 20;
   

PostgreSQL

1. SELECT export(image,'border.tif', 'compression=zip') 
     FROM border
     WHERE raster_id(image) = 10;
   

2. SELECT export(image, 'pyramid.tif', 'level=2, band=(3,2,1)')
     FROM border
     WHERE raster_id(image) = 20;
   

SQL Server

1. SELECT image.export('border.tif', 'compression=zip')
    FROM border
    WHERE image.raster_id = 10;
   

2. SELECT image.export('pyramid.tif', 'level=2, band=(3,2,1)')
   FROM border
   WHERE image.raster_id = 20;