Importe un fichier depuis Object Storage Service (OSS), MinIO ou Hadoop Distributed File System (HDFS) dans une base de données.
Syntaxe
raster ST_ImportFrom(cstring chunkTableName,
cstring url,
cstring storageOption default '{}',
cstring importOption default '{}');
Paramètres
| Paramètre | Description |
| chunkTableName | Nom de la table de chunks. Le nom doit respecter les conventions de nommage des tables de base de données. |
| url | Chemin du fichier externe. Pour plus d'informations sur la construction du chemin, consultez . |
| storageOption | Chaîne JSON spécifiant les informations de stockage de l'objet raster. |
| importOption | Chaîne JSON spécifiant les options d'importation. |
Les paramètres storageOption sont décrits ci-dessous :
| Paramètre | Type | Valeur par défaut | Description |
| chunking | boolean | true | Indique s'il faut utiliser le stockage par chunks. |
| chunkdim | string | Identique aux données brutes | Dimensions des chunks. Format : (w, h, b). Remarque Ce paramètre prend effet uniquement lorsque chunking=true. |
| compression | string | lz4 | Type d'algorithme de compression. Valeurs valides :
Par défaut : lz4 |
| quality | integer | 75 | Qualité de la compression. Ce paramètre ne s'applique qu'aux algorithmes de compression jpeg et jp2k. |
| interleaving | string | Identique aux données brutes | Méthode d'entrelacement. Valeurs valides :
|
| blockendian | string | 'NDR' | Ordre des octets pour le stockage des chunks. Valeurs valides :
|
| celltype | string | Identique aux données brutes | Type de pixel. Valeurs valides :
|
Les paramètres importOption sont décrits ci-dessous.
| Paramètre | Type | Valeur par défaut | Description |
| mapping_oss_file | boolean | false | Indique s'il faut mapper le fichier OSS vers un fichier en mémoire. Remarque Lors de la lecture des données raster, certains pilotes ne sont pas optimisés pour les données stockées dans OSS. Cela génère de nombreuses requêtes avec un faible volume de données et entraîne de faibles performances. Ce paramètre mappe l'intégralité du fichier OSS dans un objet en mémoire pour améliorer les performances. La taille totale du fichier est définie par le paramètre GUC ganos.raster.memory_oss_file_max_size. |
| parallel | integer | Valeur du paramètre GUC ganos.parallel.degree. | Définit le degré de parallélisme de l'opération. Valeurs valides : 1 à 64. |
Description
Cette fonction crée un objet raster et importe un fichier OSS externe dans cet objet.
Pour obtenir les types de données pris en charge, appelez la fonction .
Exemples
-- Specify only the foreign table name and the path
Select ST_ImportFrom('chunk_table','OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif');
-- Specify the image that corresponds to a NetCDF file with a subset
Select ST_ImportFrom('chunk_table','OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.nc:hcc');
-- Specify the chunk size and the compression type during the import
Select ST_ImportFrom('chunk_table','OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif', '{"chunkdim":"(128,128,3)", "compression":"none"}');
-- Specify the degree of parallelism during the import
Select ST_ImportFrom('chunk_table','OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.nc:hcc', '{}', '{"parallel": 4}');