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

ST\$1CoveredBy retorna true se a projeção 2D da primeira geometria de entrada for coberta pela projeção 2D da segunda geometria de entrada. A geometria `A` será coberta pela geometria `B` se ambas não estiverem vazias e todos os pontos em `A` forem um ponto em `B`. 

ST\$1CoveredBy(`A`, `B`) é equivalente a ST\$1Covers(`B`, `A`). 

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

```
ST_CoveredBy(geom1, geom2)
```

## Argumentos
<a name="ST_CoveredBy-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 é coberto por *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_CoveredBy-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_CoveredBy-function-examples"></a>

O SQL a seguir verifica se o primeiro polígono é coberto pelo segundo polígono. 

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

```
st_coveredby
-----------
 true
```