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 |
|
|
Chemin du fichier source. Pour les formats de chemin pris en charge, consultez la section Chemins de stockage d'objets. |
|
|
Chaîne JSON spécifiant les options de stockage des blocs pour la pyramide raster. |
|
|
Tableau unidimensionnel représentant le raster. La longueur du tableau doit être égale au nombre de colonnes multiplié par le nombre de lignes. |
|
|
Nombre de colonnes du raster. |
|
|
(Facultatif) Espace tridimensionnel représenté par une géométrie. |
Champs storageOption
|
Champ |
Type |
Format |
Valeur par défaut |
Description |
|
|
String |
|
Identique à la taille des blocs du fichier source |
Taille de chaque bloc utilisé pour stocker les données raster. |
|
|
String |
— |
|
Méthode d'entrelacement. Valeurs valides : |
|
|
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
interleavingest défini surbsqmais que le rendu du raster utilise une combinaison RVB multibande, définissezinterleavingsurbip.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
chunkdimsur 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"}'));