ArcGIS Server Java Help - ST

定义

ST_Raster.export 函数用于将整个 ST_Raster 对象或其某部分写入一个图像文件。该函数被设计为仅可用作 SQL SELECT 语句的选择列表的一部分。

语法

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

参数

参数	描述
filename	导出的栅格文件的名称 filename 参数为 VARCHAR 类型，所以必须用单引号将其括起来。文件的扩展名确定了将用于导出文件的栅格格式。目前所支持的栅格导出格式为 GeoTIFF。因此，要追加扩展名 .tif。
raster	要导出的 ST_Raster 值
parameter_list	用单引号括起来且以逗号分隔的参数列表可能包含以下参数： band <第 1 个波段号>[,<第 2 个波段号>],…,[第 n 个波段号]> - 以逗号分割的待导出波段的波段序号列表按波段序号的顺序导出像素数据。如果未指定参数，则所有波段都以常规波段顺序导出。 level <金字塔等级> - 待导出 ST_Raster 对象的金字塔等级；默认为基础等级 (0)。 compression <lzw \| g3 \| g4 \| zip> - 用于创建图像文件的压缩形式；默认设置为不使用压缩而创建图像文件。 window (minx,miny,maxx,maxy) - 待导出至图像文件的 ST_Raster 对象的范围（以像素坐标指定） extent (minx,miny,maxx,maxy) - 待导出至图像文件的 ST_Raster 对象的范围（以地理坐标指定） overwrite - 如果文件已存在，则将其覆盖。默认行为是返回一个错误。

描述

filename

导出的栅格文件的名称

filename 参数为 VARCHAR 类型，所以必须用单引号将其括起来。文件的扩展名确定了将用于导出文件的栅格格式。目前所支持的栅格导出格式为 GeoTIFF。因此，要追加扩展名 .tif。

raster

要导出的 ST_Raster 值

parameter_list

用单引号括起来且以逗号分隔的参数列表可能包含以下参数：

band <第 1 个波段号>[,<第 2 个波段号>],…,[第 n 个波段号]> - 以逗号分割的待导出波段的波段序号列表
按波段序号的顺序导出像素数据。如果未指定参数，则所有波段都以常规波段顺序导出。
level <金字塔等级> - 待导出 ST_Raster 对象的金字塔等级；默认为基础等级 (0)。
compression <lzw | g3 | g4 | zip> - 用于创建图像文件的压缩形式；默认设置为不使用压缩而创建图像文件。
window (minx,miny,maxx,maxy) - 待导出至图像文件的 ST_Raster 对象的范围（以像素坐标指定）
extent (minx,miny,maxx,maxy) - 待导出至图像文件的 ST_Raster 对象的范围（以地理坐标指定）
overwrite - 如果文件已存在，则将其覆盖。默认行为是返回一个错误。

示例

这些示例显示了以下内容：

如何将 ST_Raster 对象导出至名为 border.tif 的 GeoTIFF 文件
如何以降序波段顺序导出 ST_Raster 对象、GeoTIFF 文件以及 pyramid.tif 的第二金字塔等级

在这些示例中，文件被导出至处理 SQL 的 DBMS 服务器上的位置。您可能包括带有文件名的特定路径。确保该路径对于 DBMS 服务器有效。

Oracle

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

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

PostgreSQL

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

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

SQL Server

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

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

3/7/2012