

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

ST\$1GeometryN retorna uma geometria apontada pelo índice de entrada da geometria de entrada, da seguinte forma: 
+ Se a entrada for um ponto, uma linestring ou um polígono, será retornada uma geometria no estado em que se encontra se o índice for igual a um (1), e null se o índice for diferente de um (1).
+ Se a entrada for multiponto, multilinestring, multipolígono ou coleção de geometrias, será retornado um ponto, uma linestring, um polígono ou uma coleção de geometrias, conforme apontado por um índice de entrada. 

O índice é baseado em um. O Spatial Reference System Identifier (SRID – Identificador do sistema de referência espacial) do resultado é o mesmo da geometria de entrada. A dimensão da geometria retornada é a mesma geometria de entrada.

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

```
ST_GeometryN(geom, index)
```

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

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

 *Índice do*   
Um valor do tipo de dados `INTEGER` que representa a posição de um índice baseado em um. 

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

`GEOMETRY` 

Se *geom* ou *index* for null, será retornado null. 

Se *index* estiver fora do intervalo, será retornado um erro. 

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

O SQL a seguir retorna as geometrias em uma coleção de geometrias. 

```
WITH tmp1(idx) AS (SELECT 1 UNION SELECT 2),
tmp2(g) AS (SELECT ST_GeomFromText('GEOMETRYCOLLECTION(POLYGON((0 0,10 0,0 10,0 0)),LINESTRING(20 10,20 0,10 0))'))
SELECT idx, ST_AsEWKT(ST_GeometryN(g, idx)) FROM tmp1, tmp2 ORDER BY idx;
```

```
 idx |          st_asewkt           
-----+------------------------------
   1 | POLYGON((0 0,10 0,0 10,0 0))
   2 | LINESTRING(20 10,20 0,10 0)
```