Exporta um objeto raster para o Object Storage Service (OSS), Multi-Cloud Object Storage (MinIO) ou Hadoop Distributed File System (HDFS).
Sintaxe
boolean ST_ExportTo(raster source,
cstring format,
cstring url,
integer level = 0);Parâmetros
|
Parâmetro |
Descrição |
|
source |
Objeto raster a exportar. |
|
format |
Formato de saída. Os valores comuns incluem |
|
url |
URL de destino do objeto OSS, objeto MinIO ou arquivo HDFS exportado. URLs de subconjunto não são suportadas. Para obter detalhes sobre a sintaxe da URL, consulte Caminhos de armazenamento de objetos. |
|
level |
Nível da pirâmide. Valor padrão: |
Formatos suportados
A tabela a seguir lista os formatos mais comuns.
|
Formato |
Nome completo |
|
BMP |
Microsoft Windows Device Independent Bitmap (.bmp) |
|
ECW |
ERDAS Compressed Wavelets (.ecw) |
|
EHdr |
ESRI .hdr Labelled |
|
GIF |
Graphics Interchange Format (.gif) |
|
GPKG |
GeoPackage |
|
GTiff |
TIFF/BigTIFF/GeoTIFF (.tif) |
|
HDF4 |
Hierarchical Data Format Release 4 (HDF4) |
|
|
Geospatial PDF |
|
PNG |
Portable Network Graphics (.png) |
|
COG |
Cloud optimized GeoTIFF |
Para obter a lista completa de formatos suportados, chame ST_RasterDrivers.
Valor retornado
Retorna true se a exportação for bem-sucedida ou false em caso de falha.
Exemplos
-- Export a raster object as an OSS object.
Select ST_ExportTo(raster, 'GTiff', 'OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif')
from raster_table
where id=1;
-- Export a raster object as a MinIO object.
Select ST_ExportTo(raster, 'PNG', 'MIO://<ak>:<ak_secret>@10.0.XX.XX:443/mybucket/data/image.png')
from raster_table
where id=1;
-- Export a raster object as an HDFS file.
Select ST_ExportTo(raster, 'PNG', 'HDFS://<user_name>@10.0.XX.XX:8020/path/image.png')
from raster_table
where id=1;