Tous les produits
Search
Centre de documentation

PolarDB:ST_BuildPyramidUseGeomSideLen

Dernière mise à jour :Sep 14, 2026

Cette rubrique décrit la fonction ST_BuildPyramidUseGeomSideLen. Cette fonction construit une pyramide si la table vectorielle source contient une colonne enregistrant la longueur du côté de la boîte englobante des données vectorielles, et qu'un index a été créé sur cette colonne (par exemple, un index B-tree). Par rapport à la fonction ST_BuildPyramid, la fonction ST_BuildPyramidUseGeomSideLen améliore considérablement l'efficacité de la construction et de la mise à jour des pyramides.

Syntaxe

boolean ST_BuildPyramidUseGeomSideLen(cstring table, cstring geom_field, cstring geom_side_len_field, cstring fid, cstring config);

Paramètres

Nom du paramètre

Description

table

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

geom_field

Nom du champ de géométrie.

geom_side_len_field

Nom du champ qui enregistre la longueur maximale du côté de la boîte englobante de la géométrie dans la colonne geom_field.

fid

Nom du champ d'identifiant de l'entité.

config

Paramètres de création de la pyramide.

La définition du paramètre config est identique à celle de la fonction ST_BuildPyramid.

Exemples

ALTER TABLE roads
ADD COLUMN geom_side_len DOUBLE PRECISION;
CREATE OR REPLACE FUNCTION add_max_len_values() RETURNS VOID AS $$
DECLARE
  t_curs CURSOR FOR
    SELECT * FROM roads;
  t_row test_polygon_geom_side_len%ROWTYPE;
  gm GEOMETRY;
  x_min DOUBLE PRECISION;
  x_max DOUBLE PRECISION;
  y_min DOUBLE PRECISION;
  y_max DOUBLE PRECISION;
BEGIN
  FOR t_row IN t_curs LOOP
    SELECT t_row.geom INTO gm;
    SELECT ST_XMin(gm) INTO x_min;
    SELECT ST_XMax(gm) INTO x_max;
    SELECT ST_YMin(gm) INTO y_min;
    SELECT ST_YMax(gm) INTO y_max;
    UPDATE roads
      SET geom_side_len = GREATEST(x_max - x_min, y_max - y_min)
    WHERE CURRENT OF t_curs;
  END LOOP;
END;
$$ LANGUAGE plpgsql;
SELECT add_max_len_values();
CREATE INDEX ON roads USING btree(geom_side_len);

SELECT ST_BuildPyramidUseGeomSideLen('roads', 'geom', 'geom_side_len', 'id',
  '{"parallel":4}');