st_geometry_dump ( geometry [, options ] )

次の表は、st_geometry_dump プロシージャーによって返される結果を示します。

st_geometry_dump システムプロシージャーは、ジオメトリ階層を分解するときに、階層内のオブジェクト (ルートオブジェクトを含む) ごとに 1 つのローを使用します。階層内の各ジオメトリを検証して、各ジオメトリが有効かどうか、有効でない場合はその理由を調査できます。

st_geometry_dump システムプロシージャーの一部の機能は、ST_GeometryN や ST_PointN などの型固有のメソッドを使用して照合できます。

st_geometry_dump システムプロシージャーを使用して、無効なジオメトリを修正できます。

なし。

なし。

• ST_Geometry タイプの ST_IsValid メソッド
• CREATE SPATIAL REFERENCE SYSTEM 文
• st_geometry_on_invalid オプション
• STORAGE FORMAT 句、CREATE SPATIAL REFERENCE SYSTEM 文

次の例では、多角形 'Polygon ((0 0, 3 0, 3 3, 0 3, 0 0))' をそのコンポーネントジオメトリに分解します。

SELECT * FROM st_geometry_dump( 'Polygon ((0 0, 3 0, 3 3, 0 3, 0 0))', 'SetGeom=No' );

次の例は、st_geometry_dump システムプロシージャーを使用して、ジオメトリ内の無効なポイントを見つける方法を示します。この例では、LineString に経度 1200 のポイントが含まれています。このため、結果ではそのポイントと LineString の両方が無効 (valid=0) であるとレポートされています。

SET TEMPORARY OPTION st_geometry_on_invalid='Ignore';
CREATE OR REPLACE VARIABLE @geo ST_Geometry;
SET @geo = new ST_LineString( 'LineString(1200 2, 80 10)', 4326 );
SELECT * FROM dbo.st_geometry_dump( @geo, 'SetGeom=No' );

無効なデータが識別されたら、st_geometry_dump システムプロシージャーを他の空間メソッドとともに使用して、無効な要素を修正して有効なジオメトリを組み立てることができます。次の例は、経度 1200 の無効なポイントを経度 120.0 に修正する方法を示します。

SELECT ST_LineString::ST_LineStringAggr( 
    new ST_Point( IF xmax = 1200 then 120.0 ELSE xmax ENDIF, 
                  ymax, 4326 )  ORDER BY id )
FROM  dbo.st_geometry_dump( @geo )
WHERE geom_type='ST_Point';