

 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/)을 참조하세요.

# ST\$1Length
<a name="ST_Length-function"></a>

선형 지오메트리의 경우 ST\$1Length는 2D 프로젝션의 데카르트 길이를 반환합니다. 길이 단위는 입력 지오메트리의 좌표가 표현되는 단위와 동일합니다. 이 함수는 점, 다중 점 및 영역 지오메트리에 대해 0을 반환합니다. 입력이 지오메트리 컬렉션인 경우 이 함수는 컬렉션에 있는 지오메트리 길이의 합계를 반환합니다.

지오그래피의 경우 ST\$1Length는 SRID에 의해 결정된 회전 타원체에서 계산된 입력 선형 지오그래피의 2D 투영의 측지 길이를 반환합니다. 길이 단위는 미터입니다. 이 함수는 점, 다중 점 및 영역 지오그래피에 대해 0을 반환합니다. 입력이 지오메트리 컬렉션인 경우 이 함수는 컬렉션에 있는 지오그래피 길이의 합계를 반환합니다.

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

```
ST_Length(geo)
```

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

 *geo*   
`GEOMETRY` 또는 `GEOGRAPHY` 데이터 유형의 값이나 `GEOMETRY` 또는 `GEOGRAPHY` 유형으로 계산되는 표현식입니다.

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

`DOUBLE PRECISION`

*geo*가 null이면 null이 반환됩니다.

SRID 값을 찾을 수 없으면 오류가 반환됩니다.

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

다음 SQL은 다중 라인스트링의 데카르트 길이를 반환합니다.

```
SELECT ST_Length(ST_GeomFromText('MULTILINESTRING((0 0,10 0,0 10),(10 0,20 0,20 10))'));
```

```
st_length
--------------------------------
  44.142135623731
```

다음 SQL은 지오그래피에서 라인스트링의 길이를 반환합니다.

```
SELECT ST_Length(ST_GeogFromText('SRID=4326;LINESTRING(5 0,6 0,4 0)'));
```

```
 st_length 
------------------
 333958.472379804
```

다음 SQL은 지오그래피에서 점의 길이를 반환합니다.

```
SELECT ST_Length(ST_GeogFromText('SRID=4326;POINT(4 5)'));
```

```
 st_length 
-----------
 0
```