すべてのプロダクト
Search
ドキュメントセンター

PolarDB:ST_Dump

最終更新日:Jul 01, 2024

このトピックでは、ST_Dump関数について説明します。 この関数は、入力ジオメトリオブジェクトのgeometry_dump行のセットを返します。

構文

geometry_dump[]  ST_Dump(geometry  g1);

パラメーター

パラメーター

説明

g1

指定するジオメトリオブジェクト。

説明

  • この関数は、入力ジオメトリオブジェクトのコンポーネントを抽出し、入力ジオメトリオブジェクトのgeometry_dump行のセットを返します。 行の各値には、ジオメトリオブジェクトと整数の配列が含まれます。 ジオメトリオブジェクトはgeomとして表され、整数の配列はpathとして表されます。

    • ポイントオブジェクト、LineStringオブジェクト、またはポリゴンオブジェクトを指定した場合、この関数は空のパス配列と入力ジオメトリで構成される単一のレコードをgeomとして返します。

    • コレクションオブジェクトまたはMULTIオブジェクトを指定した場合、この関数はコレクションのコンポーネントと、各コンポーネントの位置を表す整数の配列を返します。

  • この関数は、ジオメトリオブジェクトを拡張するのに役立ちます。 ST_Dump関数はGROUP BY句の逆です。 たとえば、この関数を使用して、MultiPolygonオブジェクトをポリゴンオブジェクトに展開できます。

  • この関数は、円形ストリング、カーブ、多面体サーフェス、三角形、三角形不規則ネットワーク (TIN) サーフェス、および3Dオブジェクトをサポートします。

デフォルトのパラメーター設定を使用して返される結果:

SELECT (t.dump).path,ST_AsText((t.dump).geom) from (select ST_Dump('MULTILINESTRING((0 0,0 2),(0 1,0 3))'::geometry) as dump) as t;
 path |      st_astext
------+---------------------
 {1}  | LINESTRING(0 0,0 2)
 {2}  | LINESTRING(0 1,0 3)
(2 rows)