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\$1NDims
<a name="ST_NDims-function"></a>

ST\$1NDims は、ジオメトリの座標ディメンションを返します。ST\$1NDims では、ジオメトリのトポロジディメンションは考慮されません。代わりに、ジオメトリのディメンションに応じた定数値を返します。

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

```
ST_NDims(geom)
```

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

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

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

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

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

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


| 戻り値 | 入力ジオメトリのディメンション | 
| --- | --- | 
| 2 | 2D | 
| 3 | 3DZ もしくは 3DM | 
| 4 | 4D | 

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

次の SQL は、2D のライン文字列における、ディメンションの数を返します。

```
SELECT ST_NDims(ST_GeomFromText('LINESTRING(0 0,1 1,2 2,0 0)'));
```

```
st_ndims
-------------
 2
```

次の SQL は、3DZ のライン文字列における、ディメンションの数を返します。

```
SELECT ST_NDims(ST_GeomFromText('LINESTRING Z(0 0 3,1 1 3,2 2 3,0 0 3)'));
```

```
st_ndims
-------------
 3
```

次の SQL は、3DM のライン文字列における、ディメンションの数を返します。

```
SELECT ST_NDims(ST_GeomFromText('LINESTRING M(0 0 4,1 1 4,2 2 4,0 0 4)'));
```

```
st_ndims
-------------
 3
```

次の SQL は、4D のライン文字列における、ディメンションの数を返します。

```
SELECT ST_NDims(ST_GeomFromText('LINESTRING ZM(0 0 3 4,1 1 3 4,2 2 3 4,0 0 3 4)'));
```

```
st_ndims
-------------
 4
```