Tous les produits
Search
Centre de documentation

PolarDB:ST_ImportFrom

Dernière mise à jour :Oct 30, 2026

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 ST_CreateRast.
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ètreTypeValeur par défautDescription
chunkingbooleantrue Indique s'il faut utiliser le stockage par chunks.
chunkdimstringIdentique aux données brutesDimensions des chunks. Format : (w, h, b).
Remarque Ce paramètre prend effet uniquement lorsque chunking=true.
compressionstringlz4Type d'algorithme de compression. Valeurs valides :
  • none
  • jpeg
  • zlib
  • png
  • lzo
  • lz4
  • snappy
  • zstd
  • jp2k

Par défaut : lz4

qualityinteger75Qualité de la compression. Ce paramètre ne s'applique qu'aux algorithmes de compression jpeg et jp2k.
interleavingstringIdentique aux données brutesMéthode d'entrelacement. Valeurs valides :
  • bip : entrelacement par pixel
  • bil : entrelacement par ligne
  • bsq : séquentiel par bande
blockendianstring'NDR'Ordre des octets pour le stockage des chunks. Valeurs valides :
  • NDR : little endian
  • XDR : big endian
celltypestringIdentique aux données brutesType de pixel. Valeurs valides :
  • 1bb : 1 bit
  • 2bui : entier non signé 2 bits
  • 4bui : entier non signé 4 bits
  • 8bsi : entier signé 8 bits
  • 8bui : entier non signé 8 bits
  • 16bsi : entier signé 16 bits
  • 16bui : entier non signé 16 bits
  • 32bsi : entier signé 32 bits
  • 32bui : entier non signé 32 bits
  • 32bf : flottant 32 bits
  • 64bsi : entier signé 64 bits
  • 64bui : entier non signé 64 bits
  • 64bf : flottant 64 bits

Les paramètres importOption sont décrits ci-dessous.

ParamètreTypeValeur par défautDescription
mapping_oss_filebooleanfalseIndique 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.
parallelintegerValeur 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 ST_RasterDrivers.

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}');