O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/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 retorna uma geometria 3DM da geometria de entrada. Para geometrias 2D, as coordenadas `m` dos pontos não vazios na geometria de saída são todas definidas como `0`. Para geometrias 3DM, uma cópia da geometria de entrada será retornado. Para geometrias 3DZ, a geometria é projetada para o plano XY cartesiano, e as coordenadas `m` dos pontos não vazios na geometria de saída são todas definidas como `0`. Para geometrias 4D, a geometria é projetada para o espaço XYM cartesiano. Pontos vazios na geometria de entrada permanecem pontos vazios na geometria de saída.

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

```
ST_Force3DM(geom)
```

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

 *geom*   
Um valor de tipo de dados `GEOMETRY` ou uma expressão que é avaliada como um tipo `GEOMETRY`. 

## Tipo de retorno
<a name="ST_Force3DM-function-return"></a>

`GEOMETRY`. 

O valor do identificador do sistema de referência espacial (SRID - spatial reference system identifier) da geometria retornada é o valor do SRID das geometrias de entrada. 

Nulo será retornado se *geom* for nulo. 

Se *geom* estiver vazio, será retornado uma geometria vazia. 

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

O SQL a seguir retorna uma geometria 3DM de uma geometria 3DZ. 

```
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))
```