Exporte un objet raster vers Object Storage Service (OSS), Multi-Cloud Object Storage (MinIO) ou Hadoop Distributed File System (HDFS).
Syntaxe
boolean ST_ExportTo(raster source,
cstring format,
cstring url,
integer level = 0);Paramètres
| Paramètre | Description |
|---|---|
| source | Objet raster à exporter. |
| format | Format de sortie. Les valeurs courantes incluent GTiff et BMP. Pour la liste complète des formats pris en charge, consultez la section Formats pris en charge. |
| url | URL de destination de l'objet OSS, de l'objet MinIO ou du fichier HDFS exporté. Les URL partielles ne sont pas prises en charge. Pour la syntaxe des URL, reportez-vous à la rubrique Chemins d'accès au stockage d'objets. |
| level | Niveau de pyramide. Valeur par défaut : 0. |
Formats pris en charge
Le tableau suivant répertorie les formats courants.
| Format | Nom complet |
|---|---|
| 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 |
Pour obtenir la liste complète des formats pris en charge, appelez la fonction ST_RasterDrivers.
Valeur de retour
Renvoie true si l'exportation réussit, ou false en cas d'échec.
Exemples
-- 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;