文档

ST_CreateRast

更新时间:

创建一个基于阿里云对象存储服务(OSS)、MinIO和HDFS的raster对象,或者从用户指定一维数组表示的栅格对象生成raster对象。

语法

raster ST_CreateRast(cstring url);
raster ST_CreateRast(cstring url, cstring storageOption);
raster ST_CreateRast(anyarray data , integer width, cstring storageOption, geometry extent);

参数

参数名称

描述

url

OSS影像文件的路径。更多信息,请参见对象存储服务路径

storageOption

基于JSON格式的字符串,描述raster对象金字塔的分块存储信息。

createOption

基于JSON格式的字符串,描述导入选项存储信息。

data

一维数组表示的栅格对象。该数组长度为栅格的列数与行数的乘积。

width

栅格列数。

extent

geometry类型表示的空间范围(可选)。

storageOption支持的参数如下:

参数名称

描述

类型

格式

默认值

说明

chunkdim

分块的维度信息

string

(w, h, b)

从原始影像中读取分块大小

interleaving

交错方式

string

bsq

必须是以下一种:

  • bip:像素交错

  • bil:行交错

  • bsq:波段交错

  • auto:根据原始影像自动选择

chunk_table

写入chunk_table名称

string

在使用一维数组生成raster对象功能中必须指定。

说明

在通常情况下无需修改分块和交错信息,仅在特殊场景下需要修改,例如:

  • 需要多波段RGB组合浏览,但是默认值为bsq(波段交错) ,需要修改为bip(像素交错)。

  • 某些影像的分块大小为1行*n列,但是访问请求为256行*256列的规则块,需要修改为按照访问请求的大小。

createOption支持的参数如下:

参数名称

描述

类型

默认值

说明

compute_stats

导入时是否自动计算波段统计信息。

boolean

false

approx

是否使用采样方式计算。

boolean

false

当设置为true时,采用采样方式计算统计值,结果可能会不精确。

factor

采样因子。

integer

4

采样因子,表示如果采样时,n个象元作为一个采样单元,仅在approx设置为true时有效。

exclusive_nodata

是否排除nodata。

boolean

true

nodata数据不进行统计。

描述

支持的数据类型请通过ST_RasterDrivers函数获取。

示例

-- 基于OSS存储,指定accessID,accessKEY,endpoint
Select ST_CreateRast('OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif');

-- 基于Minio,指定host和port
Select ST_CreateRast('MIO://<ak>:<ak_secret>@10.0.0.1:443/mybucket/data/image.tif');

-- 基于HDFS,指定user_name
Select ST_CreateRast('HDFS://<user_name>@10.0.0.1:8020/path/image.tif');

-- 指定分块与交错方式
 Select ST_CreateRast('OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif', '{"chunkdim":"(256,256,3)","interleaving":"auto"}');

 -- 入库自动计算波段统计信息
 Select ST_CreateRast('OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif', '{"chunkdim":"(256,256,3)","interleaving":"auto"}','{"compute_stats":true}');

-- 指定具有Subset的NetCDF对应的影像
Select ST_CreateRast('OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.nc:hcc');

-- 指定具有Subset的HDF5对应的影像
Select ST_CreateRast('OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.hdf5://ds/hcc');

-- 从数组生成raster对象
select ST_FixedRid(ST_CreateRast(ARRAY[10, 11, 8, 12], 2, '{"chunktable":"rbt"}',ST_GeomFromText('POLYGON((0 0, 10 0, 10 10, 0 10, 0 0))', 4326)));

-- 通过array_agg多条记录聚合生成raster对象
select ST_FixedRid(ST_CreateRast((select array_agg(value) from point_table), 300, '{"chunktable":"rbt"}'));
  • 本页导读 (1)