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

Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、ブログ記事を参照してください。

ST_Dimension

ST_Dimension は、入力ジオメトリの固有のディメンションを返します。inherent dimension は、ジオメトリで定義されているサブタイプのディメンション値です。

ST_Dimension は、3DM、3DZ、4D ジオメトリが入力された場合、2D ジオメトリが入力された場合と同じ結果を返します。

構文

ST_Dimension(geom)

引数

geom

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

戻り型

INTEGER は geom 固有のディメンションを表します。

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

返される値は次のとおりです。

戻り値 ジオメトリのサブタイプ

0

geom が POINT または MULTIPOINT サブタイプの場合に返されます

1

geom が LINESTRING または MULTILINESTRING サブタイプの場合に返されます

2

geom が POLYGON または MULTIPOLYGON サブタイプの場合に返されます

0

geom が空の GEOMETRYCOLLECTION サブタイプの場合に返されます

コレクションのコンポーネントの最大ディメンション

geom が GEOMETRYCOLLECTION サブタイプの場合に返されます

例

次の SQL は、4 ポイントの LINESTRING の WKT (Well-Known Text) 表現を GEOMETRY オブジェクトに変換し、LINESTRING のディメンションを返します。

SELECT ST_Dimension(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));

st_dimension
-------------
1