

 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/). 

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

H3\$1ToParent exibe o ID de célula H3 principal em uma resolução principal especificada para determinado índice H3. Para obter informações sobre a indexação H3, consulte [H3](spatial-terminology.md#spatial-terminology-h3).

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

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

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

 *Índice do*   
Um valor de tipo de dados `BIGINT` ou `VARCHAR` que representa o índice de uma célula H3, ou uma expressão que determina o valor de um desses tipos de dados.

 *resolução*   
Um valor do tipo de dados `INTEGER` ou uma expressão avaliada como um tipo `INTEGER`. O valor representa a resolução do ID de célula principal. O valor deve ser 0 e a resolução do *índice*, inclusive.

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

`BIGINT`: representa o ID de célula H3 do principal.

Se o *índice* ou a *resolução* forem NULL, então NULL será exibido.

Se o *índice* for inválido, será retornado um erro.

Se a *resolução* for menor que 0 ou maior que a resolução do *índice*, um erro será exibido.

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

O comando SQL a seguir insere um VARCHAR que representa o índice de uma célula H3 e um INTEGER que representa a resolução desejada do principal desejado e exibe um BIGINT que representa o principal na resolução 0 da célula H3 de entrada.

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

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

O comando SQL a seguir insere um BIGINT que representa o índice de uma célula H3 e um INTEGER que representa a resolução desejada do principal desejado e exibe um BIGINT que representa o principal na resolução 0 da célula H3 de entrada.

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

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