Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、[ブログ記事](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)を参照してください。

# ST\$1Dimension
<a name="ST_Dimension-function"></a>

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

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

## 構文
<a name="ST_Dimension-function-syntax"></a>

```
ST_Dimension(geom)
```

## 引数
<a name="ST_Dimension-function-arguments"></a>

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

## 戻り型
<a name="ST_Dimension-function-return"></a>

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

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

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


| 戻り値 | ジオメトリのサブタイプ | 
| --- | --- | 
| 0 | *geom* が `POINT` または `MULTIPOINT` サブタイプの場合に返されます | 
| 1 | *geom* が `LINESTRING` または `MULTILINESTRING` サブタイプの場合に返されます | 
| 2 | *geom* が `POLYGON` または `MULTIPOLYGON` サブタイプの場合に返されます | 
| 0 | *geom* が空の `GEOMETRYCOLLECTION` サブタイプの場合に返されます | 
| コレクションのコンポーネントの最大ディメンション | *geom* が `GEOMETRYCOLLECTION` サブタイプの場合に返されます | 

## 例
<a name="ST_Dimension-function-examples"></a>

次の 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
```