Cette rubrique décrit la fonction ST_BuildPyramid, utilisée pour créer une pyramide pour un objet raster.
Syntaxe
raster ST_BuildPyramid(raster source,
integer pyramidLevel default -1,
ResampleAlgorithm algorithm default 'Near',
cstring chunkTableName default '',
cstring storageOption default '{}',
cstring buildOption default '{}');
Paramètres
Paramètre | Description |
source | Nom de l'objet raster. |
chunkTableName | Nom de la table de blocs stockée dans la pyramide. Ce paramètre prend effet uniquement lorsque l'objet raster est stocké dans un compartiment Object Storage Service (OSS). |
pyramidLevel | Nombre de niveaux dans la pyramide. La valeur -1 indique que le nombre maximal de niveaux doit être créé dans la pyramide. |
algorithm | Algorithme de rééchantillonnage utilisé pour créer la pyramide. Valeurs valides :
|
storageOption | Chaîne JSON utilisée pour spécifier les paramètres liés au stockage. Ces paramètres décrivent les informations de stockage des blocs de la pyramide. Cette chaîne JSON prend effet uniquement lorsque l'objet raster est stocké dans un compartiment OSS. |
buildOption | Chaîne JSON utilisée pour spécifier les paramètres liés à la création de la pyramide. PolarDB prend en charge le paramètre parallel. Ce paramètre définit le degré de parallélisme. Le type de données de ce paramètre est INTEGER. La valeur de ce paramètre varie de 1 à 64. Si vous ne spécifiez pas le paramètre parallel, la valeur du paramètre GUC ganos.parallel.degree est utilisée comme degré de parallélisme par défaut. Pour plus d'informations, consultez ganos.parallel.degree. Remarque Si vous exécutez des threads en parallèle pour créer la pyramide, les transactions ne sont pas prises en charge. Si la pyramide ne peut pas être créée ou si vous devez annuler les transactions, vous pouvez appeler la fonction ST_deletePyramid pour supprimer la pyramide. Pour plus d'informations, consultez ST_deletePyramid. |
Le tableau suivant décrit les paramètres contenus dans storageOption.
Paramètre | Type | Description |
chunkdim | string | Dimensions utilisées pour découper les données de l'objet raster. La valeur de ce paramètre suit le format |
interleaving | string | Méthode utilisée pour entrelacer les données de l'objet raster.
|
compression | string | Format de compression souhaité pour les données de l'objet raster. Valeurs valides :
|
quality | integer | Qualité de la compression. Ce paramètre prend effet uniquement lorsque vous utilisez le format de compression JPEG ou JPEG 2000. Plage de valeurs : 1 à 99. Valeur par défaut : 75.
|
Description
Cette fonction prend en charge le calcul accéléré par GPU. Par défaut, dans un environnement actif doté de GPU, GanosBase active automatiquement le calcul accéléré par GPU.
Exemples
Update raster_table set raster_obj = ST_BuildPyramid(raster_obj) where id = 1;
Update raster_table set raster_obj = ST_BuildPyramid(raster_obj, 'chunk_table') where id = 2;
-- Use JPEG 2000 to compress the data of the raster object.
-- Make sure that all bands are within one chunk.
Update raster_table set raster_obj = ST_BuildPyramid(
raster_obj,
-1,
'Near',
'chunk_table',
'{"compression":"jp2k", "quality": 75, "chunkdim":"(256,256,4)","interleaving":"auto"}')
where id = 3;
-- Create the pyramid by using parallel operations.
Update raster_table set raster_obj = ST_BuildPyramid(
raster_obj,
-1,
'Near',
'chunk_table',
'{"compression":"jp2k", "quality": 75, "chunkdim":"(256,256,4)","interleaving":"auto"}',
'{"parallel":4}')
where id = 3;