ST_Boundary - Amazon Redshift
構文引数戻り型例

ST_Boundary

ST_Boundary は、次のように入力ジオメトリの境界を返します。

  • 入力ジオメトリが空の場合 (つまり、ポイントが含まれていない場合)、そのまま返されます。

  • 入力ジオメトリがポイントまたは空ではないマルチポイントの場合、空のジオメトリコレクションが返されます。

  • 入力がライン文字列またはマルチライン文字列の場合、境界上のすべてのポイントを含むマルチポイントが返されます。マルチポイントが空である可能性があります)。

  • 入力が内部リングのないポリゴンである場合、その境界を表す閉じたライン文字列が返されます。

  • 入力が内部リングのあるポリゴンであるか、マルチポリゴンである場合、マルチライン文字列が返されます。マルチライン文字列には、面積ジオメトリ内のすべてのリングのすべての境界が閉じたライン文字列として含まれます。

ポイントの等価性を判断するために、ST_Boundary は入力ジオメトリの 2D 射影に対して作用します。入力ジオメトリが空の場合、入力のコピーが同じディメンションで返されます。空でない 3DM および 4D ジオメトリの場合、m 座標はドロップされます。3DZ および 4D マルチライン文字列の特殊なケースでは、マルチラインストリングの境界ポイントにおける z 座標は、同じ 2D 射影法を使用するライン文字列の境界ポイントにおける、個別の Z 値の平均として計算されます。

構文

ST_Boundary(geom)

引数

geom

データ型 GEOMETRY の値または GEOMETRY 型と評価される式の値。

戻り型

GEOMETRY

geom が null の場合、null が返されます。

geom が GEOMETRYCOLLECTION である場合、エラーが返されます。

例

次の SQL は、入力ポリゴンの境界をマルチライン文字列として返します。

SELECT ST_AsEWKT(ST_Boundary(ST_GeomFromText('POLYGON((0 0,10 0,10 10,0 10,0 0),(1 1,1 2,2 1,1 1))')));

st_asewkt
--------------------
 MULTILINESTRING((0 0,10 0,10 10,0 10,0 0),(1 1,1 2,2 1,1 1))