

 Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# ST\$1 CoveredBy
<a name="ST_CoveredBy-function"></a>

ST\$1 CoveredBy renvoie true si la projection 2D de la première géométrie en entrée est couverte par la projection 2D de la deuxième géométrie en entrée. La géométrie `A` est couverte par la géométrie `B` si les deux sont non vides et si chaque point dans `A` est un point dans `B`. 

ST\$1 CoveredBy (`A`,`B`) est équivalent à ST\$1Covers (`B`,). `A` 

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

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

## Arguments
<a name="ST_CoveredBy-function-arguments"></a>

 *geom1*   
Valeur de type de données `GEOMETRY` ou expression qui est évaluée sur un type `GEOMETRY`. Cette valeur est comparée à *geom2* afin de déterminer si elle est couverte par *geom2*. 

 *geom2*   
Valeur de type de données `GEOMETRY` ou expression qui est évaluée sur un type `GEOMETRY`. 

## Type de retour
<a name="ST_CoveredBy-function-return"></a>

`BOOLEAN`

Si *geom1* ou *geom2* est null, null est renvoyé. 

Si *geom1* et *geom2* n’ont pas la même valeur pour l’identifiant de système de référence spatiale (SRID), une erreur est renvoyée. 

Si *geom1* ou *geom2* est une collection géométrique, une erreur est renvoyée. 

## Exemples
<a name="ST_CoveredBy-function-examples"></a>

Le SQL suivant vérifie si le premier polygone est couvert par le deuxième polygone. 

```
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
```