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

ST\$1ConvexHull retorna uma geometria que representa o casco convexo dos pontos não vazios contidos na geometria de entrada. 

Para entrada vazia, a geometria resultante é a mesma geometria de entrada. Para todas as entradas não vazias, a função opera na projeção 2D da geometria de entrada. No entanto, a dimensão da geometria de saída depende da dimensão da geometria de entrada. Mais especificamente, quando a geometria de entrada é uma geometria 3DM ou 3D não-vazia, coordenadas `m` são descartadas. Ou seja, a dimensão da geometria retornada é 2D ou 3DZ, respectivamente. Se a entrada for uma geometria 2D ou 3DZ não vazia, a geometria resultante terá a mesma dimensão.

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

```
ST_ConvexHull(geom)
```

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

`GEOMETRY`

O valor do identificador do sistema de referência espacial (SRID - spatial reference system identifier) da geometria retornada é o valor do SRID das geometrias de entrada. 

Nulo será retornado se *geom* for nulo. 

Os valores retornados são os seguintes.


| Número de pontos no casco convexo | Subtipo de geometria | 
| --- | --- | 
| 0 | Uma cópia do *geom* é retornada.  | 
| 1 | Um subtipo `POINT` é retornado.  | 
| 2 | Um subtipo `LINESTRING` é retornado. Os dois pontos do linestring retornado são ordenados lexicograficamente. | 
| 3 ou mais | Um subtipo `POLYGON` sem anéis interiores é retornado. O polígono é orientado no sentido horário, e o primeiro ponto do anel externo é o ponto lexicograficamente mais pequeno do anel. | 

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

O seguinte SQL retorna a representação de texto conhecido estendido (EWKT) de uma linestring. Nesse caso, o casco convexo retornado é um polígono.

```
SELECT ST_AsEWKT(ST_ConvexHull(ST_GeomFromText('LINESTRING(0 0,1 0,0 1,1 1,0.5 0.5)'))) as output;
```

```
output
-------------
POLYGON((0 0,0 1,1 1,1 0,0 0))
```

O seguinte SQL retorna a representação EWKT de uma linestring. Nesse caso, o casco convexo retornado é uma linestring.

```
SELECT ST_AsEWKT(ST_ConvexHull(ST_GeomFromText('LINESTRING(0 0,1 1,0.2 0.2,0.6 0.6,0.5 0.5)'))) as output;
```

```
output
-------------
LINESTRING(0 0,1 1)
```

O seguinte SQL retorna a representação EWKT de um multiponto. Nesse caso, o casco convexo retornado é um ponto.

```
SELECT ST_AsEWKT(ST_ConvexHull(ST_GeomFromText('MULTIPOINT(0 0,0 0,0 0)'))) as output;
```

```
output
-------------
POINT(0 0)
```