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

ST\$1GeomFromText cria um objeto geometry da representação de texto bem-conhecido (WKT - well-known text) de uma geometria de entrada. 

ST\$1GeomFromText aceita 3DZ, 3DM e 4D onde o tipo de geometria é prefixado com Z, M ou ZM, respectivamente.

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

```
ST_GeomFromText(wkt_string)
```

```
ST_GeomFromText(wkt_string, srid)
```

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

 *wkt\$1string*   
Um valor de tipo de dados `VARCHAR` que é uma representação de WKT de uma geometria.  
Você pode usar a palavra-chave WKT `EMPTY` para designar um ponto vazio, um multiponto com um ponto vazio ou uma coleção de geometria com um ponto vazio. O exemplo a seguir cria um multiponto com um ponto vazio e um ponto não vazio.   

```
ST_GeomFromEWKT('MULTIPOINT(1 0,EMPTY)');
```

 *srid*   
Um valor de tipo de dados `INTEGER` que é um identificador de referência espacial (SRID - spatial reference identifier), Se o valor de um SRID for fornecido, a geometria retornada terá esse valor de SRID. Caso contrário, o valor do SRID da geometria retornada será definido como zero (0).

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

`GEOMETRY`

Nulo será retornado se *wkt\$1string* ou *srid* for nulo. 

Se *srid* for negativo, será retornado nulo. 

Se *wkt\$1string* for inválido, um erro será retornado. 

Se *srid* for inválido, um erro será retornado. 

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

O SQL a seguir cria um objeto geometria da representação de WKT e do valor de SRID. 

```
SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326);
```

```
st_geomfromtext
--------------------------------
0103000020E61000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000
```