Amazon Redshift는 패치 198부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. 기존 Python UDF는 2026년 6월 30일까지 계속 작동합니다. 자세한 내용은 [블로그 게시물](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는 주어진 H3 인덱스에 대해 지정된 상위 해상도에서 상위 H3 셀 ID를 반환합니다. H3 인덱싱에 대한 자세한 내용은 [H3](spatial-terminology.md#spatial-terminology-h3) 섹션을 참조하세요.

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

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

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

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

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

## 반환 타입
<a name="H3_ToParent-function-return"></a>

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

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

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

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

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

다음 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
```