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.

# H3\$1 ToParent
<a name="H3_ToParent-function"></a>

H3\$1 ToParent renvoie l'identifiant de la cellule H3 parent à une résolution parent spécifiée pour un index H3 donné. Pour en savoir plus sur l’indexation H3, consultez [H3](spatial-terminology.md#spatial-terminology-h3).

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

```
H3_ToParent(index, resolution)
```

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

 *index*   
Une valeur de type de données `BIGINT` ou `VARCHAR` qui représente l'index d'une cellule H3, ou une expression qui correspond à l'un de ces types de données.

 *resolution*   
Valeur de type de données `INTEGER` ou expression qui est évaluée sur un type `INTEGER`. La valeur représente la résolution de l'ID de cellule parent. La valeur doit être comprise entre 0 et la résolution de *l'indice* inclus.

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

`BIGINT`— représente l'identifiant de la cellule H3 du parent.

Si *l'index* ou *la résolution* est NULL, NULL est renvoyé.

Si *index* n’est pas valide, une erreur est renvoyée.

Si *la résolution* est inférieure à 0 ou supérieure à la résolution de *l'index*, une erreur est renvoyée.

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

Le code SQL suivant saisit un VARCHAR qui représente l'index d'une cellule H3 et un INTEGER qui représente la résolution souhaitée du parent souhaité, et renvoie un BIGINT qui représente le parent à la résolution 0 de la cellule H3 en entrée.

```
SELECT H3_ToParent('85283473fffffff', 0);
```

```
 h3_toparent
--------------------
 577199624117288959
```

Le code SQL suivant saisit un BIGINT qui représente l'index d'une cellule H3 et un INTEGER qui représente la résolution souhaitée du parent souhaité, et renvoie un BIGINT qui représente le parent à la résolution 0 de la cellule H3 en entrée.

```
SELECT H3_ToParent(646078419604526808, 8);
```

```
 h3_toparent
--------------------
 614553222213795839
```