적용 대상:
Databricks SQL
Databricks Runtime 17.1 이상으로 표시
Important
이 기능은 공개 미리보기 단계에 있습니다.
비고
이 기능은 Databricks SQL 클래식 웨어하우스에서 사용할 수 없습니다. Databricks SQL 웨어하우스에 대한 자세한 내용은 SQL 웨어하우스 유형을 참조하세요.
기하 도형에 대한 WKT 설명을 구문 분석하고 해당 GEOMETRY 값을 반환합니다.
반환된 GEOMETRY 값의 SRID 값은 지정된 경우의 sridExpr 값이거나, 그렇지 않으면 0입니다.
Syntax
st_geomfromtext ( wktExpr[, sridExpr] )
Arguments
-
wktExprSTRING: WKT 형식의 기하 도형을 나타내는 값입니다. -
sridExpr: 반환INTEGER된 값의 SRID로 설정된 선택적GEOMETRY값입니다.
Returns
상수(예측 가능한) 표현인 경우에는 GEOMETRY(srid)의 srid 값, 그렇지 않으면 sridExpr인 sridExpr 형식의 값입니다.
sridExpr가 생략될 경우 반환된 값의 형식은 GEOMETRY(0)입니다.
반환된 값은 입력 WKT 설명에 해당하는 기하 도형입니다.
입력 중 하나라도 NULL인 경우 함수는 NULL을 반환합니다.
오류 조건
- 값
wktExpr이 잘못된 WKT 설명이면 함수는 WKT_PARSE_ERROR 반환합니다. - 값
sridExpr이 지원되지 않으면 함수가 반환됩니다ST_INVALID_SRID_VALUE.
Examples
-- Simple example where we do not specify the output SRID. It defaults to 0.
> SELECT st_srid(st_geomfromtext('POINT Z (1 2 3)'));
0
-- Simple example where we specify the SRID value for the output.
> SELECT st_asewkt(st_geomfromtext('POINT Z (1 2 3)', 3857));
SRID=3857;POINT Z (1 2 3)