다음을 통해 공유


st_geomfromtext 함수

적용 대상:yes Databricks SQL 확인 표시 예 Databricks Runtime 17.1 이상으로 표시

비고

이 기능은 Databricks SQL 클래식 웨어하우스에서 사용할 수 없습니다. Databricks SQL 웨어하우스에 대한 자세한 내용은 SQL 웨어하우스 유형을 참조하세요.

기하 도형에 대한 WKT 설명을 구문 분석하고 해당 GEOMETRY 값을 반환합니다. 반환된 GEOMETRY 값의 SRID 값은 지정된 경우의 sridExpr 값이거나, 그렇지 않으면 0입니다.

Syntax

st_geomfromtext ( wktExpr[, sridExpr] )

Arguments

  • wktExpr STRING: WKT 형식의 기하 도형을 나타내는 값입니다.
  • sridExpr: 반환 INTEGER 된 값의 SRID로 설정된 선택적 GEOMETRY 값입니다.

Returns

상수(예측 가능한) 표현인 경우에는 GEOMETRY(srid)srid 값, 그렇지 않으면 sridExprsridExpr 형식의 값입니다. 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)