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

ST\$1Force3DZ retorna uma geometria 3DZ da geometria de entrada. Para geometrias 2D, as coordenadas `z` dos pontos não vazios na geometria de saída são todas definidas como `0`. Para geometrias 3DM, a geometria é projetada no plano XY cartesiano, e as coordenadas `z` dos pontos não vazios na geometria de saída são todas definidas como `0`. Para geometrias 3DZ, uma cópia da geometria de entrada será retornado. Para geometrias 4D, a geometria é projetada para o espaço XYZ-cartesiano. Pontos vazios na geometria de entrada permanecem pontos vazios na geometria de saída.

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

```
ST_Force3DZ(geom)
```

## Argumentos
<a name="ST_Force3DZ-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_Force3DZ-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_Force3DZ-function-examples"></a>

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

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

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