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

Para uma geometria linear, ST\$1Length retorna o comprimento cartesiano de uma projeção 2D. As unidades de comprimento são as mesmas unidades em que as coordenadas da geometria de entrada são expressas. A função retorna zero (0) para pontos, multipontos e geometrias de área. Quando a entrada for uma coleção de geometrias, a função retornará a soma dos comprimentos das geometrias na coleção. 

Para uma geografia, o ST\$1Length retorna o comprimento geodésico da projeção 2D de uma geografia linear de entrada computada no esferoide determinado pelo SRID. A unidade de comprimento é o metro. A função retorna zero (0) para pontos, multipontos e geografias planas. Quando a entrada for uma coleção de geometrias, a função retornará a soma dos comprimentos das geografias na coleção.

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

```
ST_Length(geo)
```

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

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

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

`DOUBLE PRECISION`

Será retornado null, se *geo* for nulo.

Se o valor de SRID não for encontrado, será retornado um erro.

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

O SQL a seguir retorna o comprimento cartesiano de uma multilinestring. 

```
SELECT ST_Length(ST_GeomFromText('MULTILINESTRING((0 0,10 0,0 10),(10 0,20 0,20 10))'));
```

```
st_length
--------------------------------
  44.142135623731
```

O SQL a seguir retorna o comprimento de uma linestring em uma geografia. 

```
SELECT ST_Length(ST_GeogFromText('SRID=4326;LINESTRING(5 0,6 0,4 0)'));
```

```
 st_length 
------------------
 333958.472379804
```

O SQL a seguir retorna o comprimento de um ponto em uma geografia. 

```
SELECT ST_Length(ST_GeogFromText('SRID=4326;POINT(4 5)'));
```

```
 st_length 
-----------
 0
```