All Products
Search
Document Center

ApsaraDB RDS:ST_BuildPyramidUseGeomSideLen

Last Updated:Sep 15, 2026

Topik ini menjelaskan fungsi ST_BuildPyramidUseGeomSideLen. Fungsi ini membangun pyramid jika tabel vektor asli memiliki kolom yang mencatat panjang sisi kotak pembatas (bounding box) dari data vektor dan telah dilengkapi indeks pada kolom tersebut—misalnya, indeks Pohon-B (B-tree). Dibandingkan dengan fungsi ST_BuildPyramid, fungsi ST_BuildPyramidUseGeomSideLen secara signifikan meningkatkan efisiensi dalam membangun dan memperbarui pyramid.

Sintaksis

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

Parameter

Nama Parameter

Deskripsi

table

Nama tabel geometri spasial.

geom_field

Nama bidang geometri.

geom_side_len_field

Nama bidang yang mencatat panjang sisi maksimum dari kotak pembatas (bounding box) untuk geometri pada kolom geom_field.

fid

Nama bidang ID fitur.

config

Parameter untuk membuat pyramid.

Definisi parameter config sama dengan yang terdapat pada ST_BuildPyramid.

Contoh

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}');