Tous les produits
Search
Centre de documentation

PolarDB:ST_BuildPyramid

Dernière mise à jour :Sep 02, 2026

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 :

  • Near

  • Average

  • Bilinear

  • Cubic

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 (w, h, b). Par défaut, la taille par bloc est obtenue à partir des données d'image d'origine.

interleaving

string

Méthode utilisée pour entrelacer les données de l'objet raster.

  • bip : entrelacement par pixel (BIP)

  • bil : entrelacement par ligne (BIL)

  • bsq : séquentiel par bande (BSQ) (valeur par défaut)

  • auto : méthode d'entrelacement spécifiée par cette fonction

compression

string

Format de compression souhaité pour les données de l'objet raster. Valeurs valides :

  • none

  • jpeg

  • zlib

  • png

  • lzo

  • LZ4 (valeur par défaut)

  • zstd

  • snappy

  • jp2k

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;