View a markdown version of this page

H3_ToParent - Amazon Redshift

Amazon Redshift dejará de admitir la creación de UDF de Python después del 30 de junio de 2026. Empezaremos a aplicarlo por fases. Para obtener más información sobre los detalles del fin de vida de Python y las opciones de migración, consulte la entrada del blog que se publicó el 30 de junio de 2025.

H3_ToParent

H3_ToParent devuelve el ID de la celda H3 principal con una resolución principal especificada para un índice H3 determinado. Para obtener más información acerca de la indexación H3, consulte H3.

Sintaxis

H3_ToParent(index, resolution)

Argumentos

Índice de

Un valor de tipo de datos BIGINT o VARCHAR que representa el índice de una celda H3, o una expresión que toma el valor de uno de estos tipos de datos.

resolution

Es un valor de tipo de dato INTEGER o una expresión que toma el valor de un tipo INTEGER. El valor representa la resolución del ID de celda secundario. El valor debe estar entre 0 y la resolución del índice, incluidos.

Tipo de retorno

BIGINT: representa el ID de celda H3 principal.

Si el índice o la resolución son NULL, se devuelve NULL.

Si index no es válido, se devuelve un error.

Si la resolución es inferior a 0 o superior a la resolución del índice, se devuelve un error.

Ejemplos

El siguiente código SQL ingresa un valor VARCHAR que representa el índice de una celda H3 y devuelve un valor INTEGER que representa la resolución deseada del principal deseado y devuelve un valor BIGINT que representa el principal en resolución 0 de la celda H3 de entrada.

SELECT H3_ToParent('85283473fffffff', 0);
h3_toparent -------------------- 577199624117288959

El siguiente código SQL ingresa un valor BIGINT que representa el índice de una celda H3 y devuelve un valor INTEGER que representa la resolución deseada del principal deseado y devuelve un valor BIGINT que representa el principal en resolución 0 de la celda H3 de entrada.

SELECT H3_ToParent(646078419604526808, 8);
h3_toparent -------------------- 614553222213795839