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

ST\$1Dimension retorna a dimensão inerente de uma geometria de entrada. A *dimensão inerente* é o valor da dimensão do subtipo que está definido na geometria. 

Para entradas de geometria 3DM, 3DZ e 4D, ST\$1Dimension retorna o mesmo resultado que para entradas de geometria 2D.

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

```
ST_Dimension(geom)
```

## Argumentos
<a name="ST_Dimension-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_Dimension-function-return"></a>

`INTEGER` que representa a dimensão inerente de *geom*. 

Nulo será retornado se *geom* for nulo. 

Os valores retornados são os seguintes.


| Valor retornado | Subtipo de geometria | 
| --- | --- | 
| 0 | Retornado se *geom* for um subtipo de `POINT` ou de `MULTIPOINT`. | 
| 1 | Retornado se *geom* for um subtipo de `LINESTRING` ou de `MULTILINESTRING`. | 
| 2 | Retornado se *geom* for um subtipo de `POLYGON` ou de `MULTIPOLYGON`. | 
| 0 | Retornado se *geom* for um subtipo de `GEOMETRYCOLLECTION` vazio. | 
| Maior dimensão dos componentes da coleção. | Retornado se *geom* for um subtipo `GEOMETRYCOLLECTION` | 

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

O SQL a seguir converte uma representação de texto bem-conhecido (WKT) de uma LINESTRING de quatro pontos em um objeto GEOMETRY e retorna a dimensão da linestring. 

```
SELECT ST_Dimension(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));
```

```
st_dimension
-------------
1
```