Справка

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;