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\$1FromPoint
<a name="H3_FromPoint-function"></a>

H3\$1FromPoint는 입력된 지오메트리 포인트 및 해상도에 따라 해당하는 H3 셀 ID를 반환합니다. H3 인덱싱에 대한 자세한 내용은 [H3](spatial-terminology.md#spatial-terminology-h3) 섹션을 참조하세요.

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

```
H3_FromPoint(geom, resolution)
```

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

 *geom*   
`GEOMETRY` 데이터 형식의 값 또는 `GEOMETRY` 형식으로 계산되는 표현식입니다. **geom은 `POINT`여야 합니다.

 *resolution*   
`INTEGER` 데이터 유형의 값 또는 `INTEGER` 유형으로 계산되는 식입니다. 값은 H3 그리드 시스템의 해상도를 나타냅니다. 값은 0에서 15까지의 정수여야 합니다. `0`이 가장 거칠고 `15`가 가장 정교합니다.

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

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

*geom*이 `POINT`이 아니면 오류가 반환됩니다.

**해상도가 범위를 벗어나면 오류가 반환됩니다.

**geom이 비어 있으면 NULL이 반환됩니다.

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

다음 SQL은 포인트 `0,0` 및 해상도 `10`에 대한 H3 셀 ID를 반환합니다.

```
SELECT H3_FromPoint(ST_GeomFromText('POINT(0 0)'), 10);
```

```
 h3_frompoint
-------------------
 623560421467684863
```