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