

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

ST\$1Force4D は、入力ジオメトリの 4D ジオメトリを返します。2D ジオメトリの場合、出力ジオメトリ内の空でないポイントにおける `z` および `m` 座標は、すべて `0` に設定されます。ジオメトリが 3DM の場合は、出力ジオメトリ内の空でないポイントの `z` 座標は、すべて `0` 設定されます。ジオメトリが 3DZ の場合は、出力ジオメトリ内の空でないポイントの `m` 座標は、すべて `0` に設定されます。4D ジオメトリの場合には、入力ジオメトリのコピーが返されます。入力ジオメトリの空のポイントは、出力ジオメトリでも空のポイントのままで維持されます。

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

```
ST_Force4D(geom)
```

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

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

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

`GEOMETRY`. 

返されたジオメトリの空間リファレンスシステム識別子 (SRID) 値が、入力ジオメトリの SRID 値です。

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

*geom* が空の場合、空のジオメトリが返されます。

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

次の SQL は、3DM ジオメトリから 4D ジオメトリを返します。

```
SELECT ST_AsEWKT(ST_Force4D(ST_GeomFromText('MULTIPOINT M(0 1 2, EMPTY, 2 3 4, 5 6 7)')));
```

```
st_asewkt
-----------
  MULTIPOINT ZM ((0 1 0 2),EMPTY,(2 3 0 4),(5 6 0 7))
```