Tous les produits
Search
Centre de documentation

PolarDB:ST_BuildPyramid

Dernière mise à jour :Aug 25, 2026

Crée une pyramide vectorielle pour une table de géométrie spatiale afin d'accélérer l'affichage des données.

Syntaxe

boolean ST_BuildPyramid(cstring table, cstring geom, cstring fid, cstring config)

Paramètres

Paramètre

Description

table

Nom de la table de géométrie spatiale.

geom

Nom du champ de géométrie.

fid

Nom du champ d'identifiant de l'entité (feature ID).

config

Paramètres de création de la pyramide, sous forme de chaîne JSON.

Le tableau suivant décrit les paramètres contenus dans config.

Paramètre

Type

Valeur par défaut

Description

name

string

Identique au nom de la table

Nom de la pyramide.

parallel

int

0

Nombre de tâches de construction parallèles. Définissez le paramètre max_prepared_transactions. La valeur 0 indique un parallélisme maximal.

tileSize

int

1024

Taille des tuiles. Doit être > 0 et < 4096.

tileExtend

int

8

Marge des tuiles (padding). Doit être > 0.

userExtent

array[double]

null

Étendue géographique personnalisée. Définissez [] avec les valeurs : minx, miny, maxx, maxy.

splitSize

int

10000

Nombre maximal d'entités déterminant la division des nœuds d'index. Une valeur plus élevée produit une pyramide plus clairsemée.

maxLevel

int

16

Niveau maximal de la pyramide. Valeurs valides : 0-20.

sourceSRS

int

-1

Système de coordonnées des données source. Si ce paramètre n'est pas défini, le SRID des métadonnées est utilisé.

destSRS

int

3857

Code EPSG du système de référence de coordonnées des tuiles de sortie. Seuls les codes 3857 et 4326 sont pris en charge.

updateExtentSRS

int

4326

Format EPSG utilisé pour la plage de mise à jour de la fonction de mise à jour de la pyramide. Pour plus de détails, consultez la description de la fonction ST_UpdatePyramid.

updateBoxScale

int

10

Affecte la précision de l'opération de mise à jour de la pyramide. Pour plus de détails, consultez la description de la fonction ST_UpdatePyramid.

buildRules

array[object]

null

Règles de construction. Chaque objet contient les valeurs level et value.

└level

array[int]

null

Niveaux auxquels la règle s'applique.

└value

object

null

Valeur de la règle de construction.

└filter

string

""

Expression de filtre utilisant la syntaxe de requête PostgreSQL.

└attrFields

array[string]

null

Noms des champs d'attributs dans la sortie MVT.

└merge

array[string]

null

Conditions de filtre pour le regroupement et la fusion.

Exemple de configuration pour config :

{
   "name" : "hello",           
   "parallel": 4,         
   "tileSize": 512,           
   "tileExtend": 8,
   "userExtent": [-180,-90,180,90],
   "splitSize": 5000,
   "maxLevel": 16,  
   "destSRS": 3857,
   "buildRules": [             
     {
       "level": [0,1,2],  
       "value": {
         "filter": "code!=0",
         "attrFields": ["name","color"],    
         "merge":["code=1"]
       }
     }
   ]
}

Exemple

-- Create a vector pyramid for the spatial geometry table roads.
select ST_BuildPyramid('roads', 'geom', 'id', '');
st_buildpyramid
----------
t