ST_GEOMETRYFROMWKT

ST_GEOMETRYFROMWKT

WKT(well-known text) 또는 EWKT(확장 well-known text) 입력을 파싱해 GEOMETRY 타입의 값을 반환해요.

별칭(Aliases):

  • ST_GEOMFROMWKT, ST_GEOMETRYFROMEWKT, ST_GEOMFROMEWKT, ST_GEOMETRYFROMTEXT, ST_GEOMFROMTEXT

참고 항목:

  • TO_GEOMETRY

출처: Snowflake SQL Reference - ST_GEOMETRYFROMWKT

본문

구문

ST_GEOMETRYFROMWKT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMFROMWKT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMETRYFROMEWKT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMFROMEWKT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMETRYFROMTEXT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMFROMTEXT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )

인자

필수:

varchar_expression

  • 인자는 유효한 지리공간 객체를 나타내는 WKT 또는 EWKT 문자열 표현식이어야 해요.

선택:

srid

  • 사용할 SRID의 정수 값이에요.

allow_invalid

  • TRUE이면 입력 모양이 유효하지 않고 복구할 수 없어도 함수가 GEOGRAPHY 또는 GEOMETRY 객체를 반환하도록 지정해요. 자세한 내용은 잘못된 지리공간 모양 처리 방법 지정(Specifying how invalid geospatial shapes are handled) 문서를 참고해요.

반환

이 함수는 GEOMETRY 타입의 값을 반환해요.

사용법 참고 사항

  • 입력을 WKT 또는 EWKT로 파싱할 수 없으면 오류를 발생해요.
  • WKT 입력의 경우 srid 인자를 지정하지 않으면 결과 GEOMETRY 객체의 SRID는 0으로 설정돼요.

예제

다음 예제는 EWKT 형식으로 설명된 지리공간 객체에 대한 GEOMETRY 객체를 반환해요.

-- Set the output format to EWKT
ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)');

+---------------------------------------------------------------+
| ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)') |
|---------------------------------------------------------------|
| SRID=32633;POINT(389866.35 5819003.03)                        |
+---------------------------------------------------------------+

다음 예제는 Z 좌표가 있는 지리공간 객체를 EWKT 형식으로 설명한 GEOMETRY 객체를 반환해요.

-- Set the output format to EWKT
ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT ST_GEOMETRYFROMEWKT('SRID=32633;POINTZ(389866.35 5819003.03 30)');

+-------------------------------------------------------------------+
| ST_GEOMETRYFROMEWKT('SRID=32633;POINTZ(389866.35 5819003.03 30)') |
|-------------------------------------------------------------------|
| SRID=32633;POINTZ(389866.35 5819003.03 30)                        |
+-------------------------------------------------------------------+

다음 예제에서 입력은 WKT 형식이고, 함수 호출이 사용할 SRID를 지정해요.

-- Set the output format to EWKT
ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)', 4326);

+----------------------------------------------------------+
| ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)', 4326)  |
|----------------------------------------------------------|
| SRID=4326;POINT(389866.35 5819003.03)                    |
+----------------------------------------------------------+

더 알아보기