Tous les produits
Search
Centre de documentation

PolarDB:ST_CreateRast

Dernière mise à jour :Sep 21, 2026

Crée un objet raster à partir d'un fichier stocké dans un compartiment OSS, un compartiment MinIO ou un fichier HDFS. Crée également un objet raster à partir d'un tableau unidimensionnel.

Syntaxe

raster ST_CreateRast(cstring url);
raster ST_CreateRast(cstring url, cstring storageOption);
raster ST_CreateRast(anyarray data, integer width, cstring storageOption, geometry extent);

Paramètres

Paramètre

Description

url

Chemin du fichier source. Pour les formats de chemin pris en charge, consultez la section Chemins de stockage d'objets.

storageOption

Chaîne JSON spécifiant les options de stockage des blocs pour la pyramide raster.

data

Tableau unidimensionnel représentant le raster. La longueur du tableau doit être égale au nombre de colonnes multiplié par le nombre de lignes.

width

Nombre de colonnes du raster.

extent

(Facultatif) Espace tridimensionnel représenté par une géométrie.

Champs storageOption

Champ

Type

Format

Valeur par défaut

Description

chunkdim

String

(w,h,b)

Identique à la taille des blocs du fichier source

Taille de chaque bloc utilisé pour stocker les données raster.

interleaving

String

—

bsq

Méthode d'entrelacement. Valeurs valides : bip (bande entrelacée par pixel), bil (bande entrelacée par ligne), bsq (séquentiel par bande), auto (déterminé automatiquement).

chunk_table

String

—

Aucun

Nom de la table de blocs. Obligatoire lors de la création d'un objet raster à partir d'un tableau unidimensionnel.

Remarques sur l'utilisation

Remplacez les valeurs par défaut de chunkdim et interleaving uniquement dans les cas suivants :

  • Affichage multibande RVB : si interleaving est défini sur bsq mais que le rendu du raster utilise une combinaison RVB multibande, définissez interleaving sur bip.

  • Incompatibilité de la taille des blocs : si l'image source comporte des blocs de 1 ligne × n colonnes mais que vous avez besoin de blocs de 256 × 256, définissez chunkdim sur la taille de bloc souhaitée.

Pour obtenir la liste des formats de données pris en charge, appelez la fonction ST_RasterDrivers.

Exemples

Tous les exemples utilisent ST_CreateRast pour créer des objets rasters à partir de différents backends de stockage.

-- Create a raster object from an OSS file using AccessKey credentials and an internal endpoint.
SELECT ST_CreateRast('OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif');

-- Create a raster object from a MinIO bucket using the host and port in the URL.
SELECT ST_CreateRast('OSS://<ak>:<ak_secret>@10.0.XX.XX:443/mybucket/data/image.tif');

-- Create a raster object from an HDFS file using a username in the URL.
SELECT ST_CreateRast('HDFS://<user_name>@10.0.XX.XX:8020/path/image.tif');

-- Create a raster object with custom chunk dimensions and interleaving.
SELECT ST_CreateRast('OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.tif', '{"chunkdim":"(256,256,3)","interleaving":"auto"}');

-- Create a raster object from a NetCDF file and select the hcc subset.
SELECT ST_CreateRast('OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/data/image.nc:hcc');

-- Create a raster object from a one-dimensional array with a geometry extent.
SELECT ST_FixedRid(ST_CreateRast(ARRAY[10, 11, 8, 12], 2, '{"chunktable":"rbt"}', ST_GeomFromText('POLYGON((0 0, 10 0, 10 10, 0 10, 0 0))', 4326)));

-- Create a raster object by aggregating values from a table using array_agg.
SELECT ST_FixedRid(ST_CreateRast((SELECT array_agg(value) FROM point_table), 300, '{"chunktable":"rbt"}'));