O Amazon Redshift deixará de oferecer suporte ao uso de UDFs em Python após 30 de junho de 2026. Começaremos a aplicar essa alteração em fases. Consulte mais informações sobre os detalhes do fim da vida útil do Python e as opções de migração na [publicação do blog](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/) publicada em 30 de junho de 2025. 

# H3\_ToParent
<a name="H3_ToParent-function"></a>

H3\_ToParent 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
```