

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

ST\$1Within retorna true se a projeção 2D da primeira geometria de entrada estiver dentro da projeção 2D da segunda geometria de entrada. 

Por exemplo, a geometria `A` estará dentro da geometria `B` se todos os pontos em `A` forem um ponto em `B` e seus interiores tiverem interseção não vazia. 

ST\$1Within(`A`, `B`) é equivalente a ST\$1Contains(`B`, `A`). 

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

```
ST_Within(geom1, geom2)
```

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

 *geom1*   
Um valor de tipo de dados `GEOMETRY` ou uma expressão que é avaliada como um tipo `GEOMETRY`. Esse valor é comparado com *geom2* para determinar se ele está dentro de *geom2*. 

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

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

`BOOLEAN`

Nulo será retornado se *geom1* ou *geom2* for nulo. 

Um erro será retornado se *geom1* e *geom2* não tiverem o mesmo valor do identificador do sistema referência espacial (SRID -spatial reference system identifier). 

Um erro será retornado se *geom1* ou *geom2* for uma coleção de geometrias. 

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

O SQL a seguir verifica se o primeiro polígono está dentro do segundo polígono. 

```
SELECT ST_Within(ST_GeomFromText('POLYGON((0 2,1 1,0 -1,0 2))'), ST_GeomFromText('POLYGON((-1 3,2 1,0 -3,-1 3))'));
```

```
st_within
-----------
 true
```