적용 대상:
Databricks SQL
Databricks Runtime 17.1 이상으로 표시
Important
이 기능은 공개 미리보기 단계에 있습니다.
비고
이 기능은 Databricks SQL 클래식 웨어하우스에서 사용할 수 없습니다. Databricks SQL 웨어하우스에 대한 자세한 내용은 SQL 웨어하우스 유형을 참조하세요.
입력된 지리 공간적 값이 비어있지 않은 라인스트링일 경우, 입력 GEOGRAPHY 또는 GEOMETRY 값의 첫 번째 지점을 반환합니다.
Syntax
st_startpoint ( geoExpr )
Arguments
-
geoExpr: 줄 문자열을 나타내는 AGEOGRAPHY또는GEOMETRY값입니다.
Returns
라인스트링의 첫 번째 점을 나타내는 GEOGRAPHY 또는 GEOMETRY 타입의 값입니다.
출력 지점의 SRID 값은 입력 값의 값과 동일합니다.
출력 지점의 차원은 입력 줄 바꿈의 차원과 동일합니다.
입력이 NULL인 경우 함수는 NULL을 반환합니다.
오류 조건
-
geoExpr의 값이 linestring이 아니면, 함수는 ST_INVALID_ARGUMENT.INVALID_TYPE을 반환합니다. - 값
geoExpr이 빈 라인스트링이면 함수는 ST_INVALID_ARGUMENT.EMPTY_LINESTRING를 반환합니다.
Examples
-- Returns first point of linestring with SRID.
> SELECT st_asewkt(st_startpoint(st_geomfromtext('LINESTRING(1 2,3 4,5 6)', 4326)));
SRID=4326;POINT(1 2)
-- Returns first point with ZM coordinates.
> SELECT st_asewkt(st_startpoint(st_geogfromtext('LINESTRING ZM (1 2 3 4,5 6 7 8)')));
SRID=4326;POINT ZM (1 2 3 4)