说明

提取几何组件的集合返回函数 (SRF)。它返回一组 geometry_dump 行，每一行都包含一个几何（geom 字段）和一个整数数组（path 字段）。

对于原子几何类型（POINT、LINESTRING、POLYGON），将返回一条记录，其中 path 数组为空，输入几何为 geom。对于集合或多几何，将为集合的每个组件返回一条记录，path 表示组件在集合中的位置。

ST_Dump 对于扩展几何非常有用。它是 ST_Collect / GROUP BY 的逆函数，因为它创建新行。例如，它可用于将多边形扩展为多边形。

增强：2.0.0 引入了对多面体曲面、三角形和 TIN 的支持。

可用性：PostGIS 1.0.0RC1。需要 PostgreSQL 7.3 或更高版本。

	在 1.3.4 之前，如果将此函数与包含曲线的几何一起使用，该函数会崩溃。此问题已在 1.3.4+ 中修复。

此方法支持圆形字符串和曲线。

此函数支持多面体曲面。

此函数支持三角形和三角不规则网络曲面 (TIN)。

此函数支持 3d，并且不会删除 z 索引。

标准示例

SELECT sometable.field1, sometable.field1,
      (ST_Dump(sometable.geom)).geom AS geom
FROM sometable;

-- Break a compound curve into its constituent linestrings and circularstrings
SELECT ST_AsEWKT(a.geom), ST_HasArc(a.geom)
  FROM ( SELECT (ST_Dump(p_geom)).geom AS geom
         FROM (SELECT ST_GeomFromEWKT('COMPOUNDCURVE(CIRCULARSTRING(0 0, 1 1, 1 0),(1 0, 0 1))') AS p_geom) AS b
        ) AS a;
          st_asewkt          | st_hasarc
-----------------------------+----------
 CIRCULARSTRING(0 0,1 1,1 0) | t
 LINESTRING(1 0,0 1)         | f
(2 rows)

多面体曲面、TIN 和三角形示例

-- Polyhedral surface example
-- Break a Polyhedral surface into its faces
SELECT (a.p_geom).path[1] As path, ST_AsEWKT((a.p_geom).geom) As geom_ewkt
  FROM (SELECT ST_Dump(ST_GeomFromEWKT('POLYHEDRALSURFACE(
((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),  ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)),  ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1))
)') ) AS p_geom )  AS a;

 path |                geom_ewkt
------+------------------------------------------
    1 | POLYGON((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0))
    2 | POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0))
    3 | POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0))
    4 | POLYGON((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0))
    5 | POLYGON((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0))
    6 | POLYGON((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1))

-- TIN --
SELECT (g.gdump).path, ST_AsEWKT((g.gdump).geom) as wkt
  FROM
    (SELECT
       ST_Dump( ST_GeomFromEWKT('TIN (((
                0 0 0,
                0 0 1,
                0 1 0,
                0 0 0
            )), ((
                0 0 0,
                0 1 0,
                1 1 0,
                0 0 0
            ))
            )') ) AS gdump
    ) AS g;
-- result --
 path |                 wkt
------+-------------------------------------
 {1}  | TRIANGLE((0 0 0,0 0 1,0 1 0,0 0 0))
 {2}  | TRIANGLE((0 0 0,0 1 0,1 1 0,0 0 0))

另请参见

geometry_dump，第 12.6 节，“PostGIS 几何 / 地理 / 光栅转储函数”，ST_Collect，ST_GeometryN