ST_GEOGRAPHYFROMWKT

ST_GEOGRAPHYFROMWKT (WKT에서 GEOGRAPHY 변환)

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

별칭: ST_GEOGFROMWKT, ST_GEOGRAPHYFROMEWKT, ST_GEOGFROMEWKT, ST_GEOGRAPHYFROMTEXT, ST_GEOGFROMTEXT

참조: TO_GEOGRAPHY

출처: Snowflake SQL Reference - ST_GEOGRAPHYFROMWKT

본문

구문

ST_GEOGRAPHYFROMWKT( <varchar_expression> [, <allow_invalid> ] )

ST_GEOGFROMWKT( <varchar_expression> [, <allow_invalid> ] )

ST_GEOGRAPHYFROMEWKT( <varchar_expression> [, <allow_invalid> ] )

ST_GEOGFROMEWKT( <varchar_expression> [, <allow_invalid> ] )

ST_GEOGRAPHYFROMTEXT( <varchar_expression> [, <allow_invalid> ] )

ST_GEOGFROMTEXT( <varchar_expression> [, <allow_invalid> ] )

인자

필수:

varchar_expression

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

선택:

allow_invalid

TRUE면 입력 도형이 유효하지 않고 복구할 수 없더라도 함수가 GEOGRAPHY 또는 GEOMETRY 객체를 반환하도록 지정해요. 자세한 내용은 Specifying how invalid geospatial shapes are handled을 참고해요.

반환 값

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

사용상 주의사항

  • 입력을 WKT 또는 EWKT로 파싱할 수 없으면 오류를 발생시켜요.
  • 입력 형식이 EWKT이고 SRID가 4326이 아니면 오류를 발생시켜요. EWKT 및 EWKB 처리에 대한 참고 사항을 참고해요.
  • WKT, EWKT, GeoJSON의 좌표의 경우 경도가 위도 앞에 나타나요(예: POINT(lon lat)).

예시

다음 예시는 WKT 형식으로 설명된 지리 공간 객체에 대한 GEOGRAPHY 객체를 반환해요:

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';

select ST_GEOGRAPHYFROMWKT('POINT(-122.35 37.55)');

+---------------------------------------------+
| ST_GEOGRAPHYFROMWKT('POINT(-122.35 37.55)') |
|---------------------------------------------|
| POINT(-122.35 37.55)                        |
+---------------------------------------------+

다음 예시는 WKT 형식으로 Z 좌표가 있는 지리 공간 객체에 대한 GEOGRAPHY 객체를 반환해요:

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';

select ST_GEOGRAPHYFROMWKT('POINTZ(-122.35 37.55 30)');

+-------------------------------------------------+
| ST_GEOGRAPHYFROMWKT('POINTZ(-122.35 37.55 30)') |
|-------------------------------------------------|
| POINTZ(-122.35 37.55 30)                        |
+-------------------------------------------------+

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

-- Set the output format to EWKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='EWKT';

select ST_GEOGRAPHYFROMEWKT('SRID=4326;POINT(-122.35 37.55)');

+--------------------------------------------------------+
| ST_GEOGRAPHYFROMEWKT('SRID=4326;POINT(-122.35 37.55)') |
|--------------------------------------------------------|
| SRID=4326;POINT(-122.35 37.55)                         |
+--------------------------------------------------------+

더 알아보기