H3_ToParent - Amazon Redshift

Amazon Redshift는 2025년 11월 1일부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. Python UDF를 사용하려면 이 날짜 이전에 UDF를 생성하세요. 기존 Python UDF는 정상적으로 계속 작동합니다. 자세한 내용은 블로그 게시물을 참조하세요.

H3_ToParent

H3_ToParent는 주어진 H3 인덱스에 대해 지정된 상위 해상도에서 상위 H3 셀 ID를 반환합니다. H3 인덱싱에 대한 자세한 내용은 H3 섹션을 참조하세요.

구문

H3_ToParent(index, resolution)

인수

인덱스

H3 셀의 인덱스를 나타내는 BIGINT 또는 VARCHAR 데이터 유형의 값이나 이러한 데이터 유형으로 평가되는 표현식입니다.

resolution

INTEGER 데이터 유형의 값 또는 INTEGER 유형으로 계산되는 식입니다. 값은 상위 셀 ID의 해상도를 나타냅니다. 값은 0과 인덱스 해상도 사이여야 합니다.

반환 타입

BIGINT - 상위의 H3 셀 ID를 나타냅니다.

인덱스 또는 해상도가 NULL이면 NULL이 반환됩니다.

index가 유효하지 않으면 오류가 반환됩니다.

해상도가 0보다 작거나 인덱스 해상도보다 크면 오류가 반환됩니다.

예제

다음 SQL은 H3 셀의 인덱스를 나타내는 VARCHAR와 원하는 상위의 원하는 해상도를 나타내는 INTEGER를 입력하고, 입력 H3 셀의 해상도 0에서 상위를 나타내는 BIGINT를 반환합니다.

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

다음 SQL은 H3 셀의 인덱스를 나타내는 BIGINT와 원하는 상위의 원하는 해상도를 나타내는 INTEGER를 입력하고, 입력 H3 셀의 해상도 0에서 상위를 나타내는 BIGINT를 반환합니다.

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