ラスターオブジェクトを、Object Storage Service (OSS) バケット、Multi-Cloud Object Storage (MinIO) バケット、または Hadoop 分散ファイルシステム (HDFS) ファイルにエクスポートします。
構文
boolean ST_ExportTo(raster source,
cstring format,
cstring url,
integer level = 0);パラメーター
| パラメーター | 説明 |
|---|---|
| source | エクスポートするラスターオブジェクトです。 |
| format | 出力フォーマットです。一般的な値:GTiff、PNG、BMP。サポートされるフォーマットの完全なリストについては、以下のサポートされるフォーマットの表をご参照ください。 |
| url | エクスポート先の OSS オブジェクト、MinIO オブジェクト、または HDFS ファイルの送信先 URL です。サブセット URL はサポートされていません。URL 構文の詳細については、「オブジェクトストレージパス」をご参照ください。 |
| level | ピラミッドレベルです。デフォルト値:0。 |
サポートされるフォーマット
| フォーマット | 正式名称 |
|---|---|
| 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 |
ランタイムでサポートされるすべてのフォーマットを照会するには、ST_RasterDrivers を呼び出してください。
戻り値
エクスポートが成功した場合は true、失敗した場合は false を返します。
使用例
OSS に GTiff 形式でラスターオブジェクトをエクスポートします:
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;MinIO に PNG 形式でラスターオブジェクトをエクスポートします:
SELECT ST_ExportTo(raster, 'PNG', 'MIO://<ak>:<ak_secret>@10.0.XX.XX:443/mybucket/data/image.png')
FROM raster_table
WHERE id = 1;HDFS に PNG 形式でラスターオブジェクトをエクスポートします:
SELECT ST_ExportTo(raster, 'PNG', 'HDFS://<user_name>@10.0.XX.XX:8020/path/image.png')
FROM raster_table
WHERE id = 1;