Tous les produits
Search
Centre de documentation

ApsaraDB RDS:ST_BuildPyramid

Dernière mise à jour :Aug 20, 2026

Crée une pyramide vectorielle pour une table de données géométriques spatiales afin d'accélérer le rendu des données spatiales.

Syntaxe

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

Paramètres

Paramètre Description
table Nom de la table de données géométriques spatiales.
geom Nom de la colonne géométrique.
fid Nom du champ d'identifiant d'élément.
config Configuration de la pyramide, spécifiée sous forme de chaîne JSON.

Champs de configuration

Champ Type Par défaut Description
name string Identique au nom de la table Nom de la pyramide.
parallel integer 0 Nombre maximal de tâches exécutées en parallèle pour construire la pyramide. Le paramètre max_prepared_transactions doit être défini. Définissez la valeur sur 0 pour supprimer la limite.
tileSize integer 1024 Taille des tuiles de la pyramide. Valeurs valides : supérieures à 0 et inférieures à 4096.
tileExtend integer 8 Taille d'extension des tuiles de la pyramide. Valeurs valides : supérieures à 0.
userExtent array[double] null Étendue géographique de la pyramide, définie comme un tableau JSON contenant quatre valeurs : minx, miny, maxx et maxy. Définissez la valeur sur [] pour utiliser une valeur nulle.
splitSize integer 10000 Nombre maximal d'éléments par division de nœud d'index. Une valeur plus élevée produit une pyramide plus clairsemée.
maxLevel integer 16 Nombre maximal de niveaux de pyramide. Valeurs valides : de 0 à 20.
sourceSRS integer -1 Système de référence spatiale (SRS) des données source. Par défaut, la fonction lit les identifiants de référence spatiale (SRID) à partir des métadonnées de la table.
destSRS integer 3857 Code EPSG du système de coordonnées des tuiles. Valeurs valides : 3857 (EPSG 3857) et 4326 (EPSG 4326).
buildRules array[object] null Règles de construction de la pyramide. Plusieurs règles sont prises en charge.

Champs buildRules

Champ Type Description
level array[integer] Niveaux de pyramide auxquels la règle s'applique.
value object Configuration de la règle. Contient les sous-champs suivants : filter, attrFields et merge.
value.filter string Expression de filtre PostgreSQL à appliquer aux données.
value.attrFields array[string] Champs d'attribut à inclure lors de l'utilisation du format Mapbox Vector Tile (MVT).
value.merge array[string] Conditions de filtre pour le regroupement des enregistrements de données.

Exemple de configuration

{
   "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"]
       }
     }
   ]
}

Exemples

Construisez une pyramide pour une table de données géométriques spatiales nommée roads :

SELECT ST_BuildPyramid('roads', 'geom', 'id', '');

Sortie attendue :

st_buildpyramid
---------------
t