从补丁 198 开始，Amazon Redshift 将不再支持创建新的 Python UDF。现有的 Python UDF 将继续正常运行至 2026 年 6 月 30 日。有关更多信息，请参阅[博客文章](https://www.amazonaws.cn/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

# ST\$1Force3DM
<a name="ST_Force3DM-function"></a>

ST\$1Force3DM 返回输入几何体的 3DM 几何体。对于 2D 几何体，输出几何体中非空点的 `m` 坐标全部设置为 `0`。对于 3DM 几何体，将返回输入几何体的副本。对于 3DZ 几何体，几何体将投影到 xy 笛卡尔平面，而输出几何体中的非空点的 `m` 坐标将全部设置为 `0`。对于 4D 几何体，几何体将投影到 xym 笛卡尔空间。输入几何体中的空点仍然是输出几何体中的空点。

## 语法
<a name="ST_Force3DM-function-syntax"></a>

```
ST_Force3DM(geom)
```

## 参数
<a name="ST_Force3DM-function-arguments"></a>

 *geom*   
一个 `GEOMETRY` 数据类型的值，或一个计算结果为 `GEOMETRY` 类型的表达式。

## 返回类型
<a name="ST_Force3DM-function-return"></a>

`GEOMETRY`. 

返回的几何体的空间参考系统标识符 (SRID) 值是输入几何体的 SRID 值。

如果 *geom* 为 null，则返回 null。

如果 *geom* 为空，则返回一个空的几何体。

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

以下 SQL 从 3DZ 几何体中返回 3DM 几何体。

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

```
st_asewkt
-----------
  MULTIPOINT M ((0 1 0),EMPTY,(2 3 0),(5 6 0))
```