入力ジオメトリに対して、geometry_dump 型の行セットを返します。各行には、ジオメトリを保持する geom フィールドと、入力ジオメトリ内におけるポイントの位置を識別する整数配列を保持する path フィールドが含まれます。
構文
geometry_dump[] ST_DumpPoints(geometry geom);パラメーター
| パラメーター | 説明 |
|---|---|
| geom | 入力ジオメトリです。 |
説明
path フィールドは 1 起点の整数配列で、入力ジオメトリ内の各ポイントの位置を識別します。
LineString：
{i}を返します。ここで、iは LineString 内のポイントの 1 起点インデックスです。Polygon：
{i, j}を返します。ここで、iはリングの 1 起点インデックス（1 = 外側リング）であり、jはそのリング内のポイントの 1 起点インデックスです。
ST_DumpPoints は、円弧文字列、曲線、多面体サーフェス、三角形、不規則三角網（TIN）サーフェス、および 3D オブジェクトをサポートします。
使用例
次の例では、MULTILINESTRING のポイントをダンプします。path 値の最初の要素はライン（1 または 2）を、2 番目の要素はそのライン内のポイントを識別します。
SELECT (t.dump).path, ST_AsText((t.dump).geom)
FROM (
SELECT ST_DumpPoints('MULTILINESTRING((0 0,0 2),(0 1,0 3))'::geometry) AS dump
) AS t;出力：
path | st_astext
-------+------------
{1,1} | POINT(0 0)
{1,2} | POINT(0 2)
{2,1} | POINT(0 1)
{2,2} | POINT(0 3)
(4 rows)