

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

ST\$1Envelope retorna a caixa delimitadora mínima da geometria de entrada, da seguinte forma:
+ Se a geometria de entrada for vazia, a geometria retornada será uma cópia da geometria de entrada. 
+ Se a caixa delimitadora mínima da geometria de entrada se degenerar para um ponto, a geometria retornada será um ponto. 
+ Se a caixa delimitadora mínima da geometria de entrada for unidimensional, será retornada uma linestring de dois pontos.
+ Se nenhum dos anteriores for verdadeiro, a função retornará um polígono orientado no sentido horário, cujos vértices serão os cantos da caixa delimitadora mínima.

O Spatial Reference System Identifier (SRID – Identificador do sistema de referência espacial) da geometria retornada é o mesmo da geometria de entrada. 

Para todas as entradas não vazias, a função opera na projeção 2D da geometria de entrada. 

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

```
ST_Envelope(geom)
```

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

`GEOMETRY` 

Nulo será retornado se *geom* for nulo. 

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

O SQL a seguir converte uma representação de Well-known text (WKT – Texto bem-conhecido) de uma `LINESTRING` de quatro pontos para um objeto `GEOMETRY` e retorna um polígono cujos vértices são a caixa delimitadora mínima. 

```
SELECT ST_AsText(ST_Envelope(ST_GeomFromText('GEOMETRYCOLLECTION(POLYGON((0 0,10 0,0 10,0 0)),LINESTRING(20 10,20 0,10 0))')));
```

```
    st_astext
------------------------------------
  POLYGON((0 0,0 10,20 10,20 0,0 0))
```