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