TO_GEOGRAPHY

TO_GEOGRAPHY

입력을 파싱해서 GEOGRAPHY 타입의 값을 돌려주는 변환 함수예요. WKT, WKB, EWKT, EWKB, GeoJSON 같은 형식의 문자열·바이너리·VARIANT·GEOMETRY 값을 지리 공간 객체로 바꿀 때 써요.

출처: 공식 문서

본문

입력을 파싱하고 GEOGRAPHY 타입의 값을 반환합니다.

참고 (See also): TRY_TO_GEOGRAPHY , ST_GEOGRAPHYFROMWKB , ST_GEOGRAPHYFROMWKT

구문 (Syntax)

다음 중 하나를 사용합니다:

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

TO_GEOGRAPHY( <binary_expression> [ , <allow_invalid> ] )

TO_GEOGRAPHY( <variant_expression> [ , <allow_invalid> ] )

TO_GEOGRAPHY( <geometry_expression> [ , <allow_invalid> ] )

인자 (Arguments)

필수 (Required):

varchar_expression

인자는 다음 형식 중 하나로 유효한 기하 객체를 나타내는 문자열 표현식이어야 합니다: WKT(well-known text), WKB(well-known binary) 16진수 형식(앞의 0x 없음), EWKT(extended well-known text), EWKB(extended well-known binary) 16진수 형식(앞의 0x 없음), GeoJSON.

binary_expression

인자는 WKB 또는 EWKB 형식의 바이너리 표현식이어야 합니다.

variant_expression

인자는 GeoJSON 형식의 OBJECT여야 합니다.

geometry_expression

인자는 SRID가 4326인 GEOMETRY 타입의 표현식이어야 합니다.

선택 (Optional):

allow_invalid

TRUE이면, 입력 모양이 유효하지 않고 복구할 수 없더라도 함수가 GEOGRAPHY 또는 GEOMETRY 객체를 반환하도록 지정합니다. 자세한 내용은 "유효하지 않은 지리 공간 모양 처리 방법 지정"을 참고하세요.

반환값 (Returns)

함수는 GEOGRAPHY 타입의 값을 반환합니다.

사용 참고 (Usage notes)

  • 입력을 지원되는 형식(WKT, WKB, EWKT, EWKB, GeoJSON) 중 하나로 파싱할 수 없으면 오류를 발생시킵니다.
  • 입력 형식이 EWKT 또는 EWKB이고 SRID가 4326이 아니면 오류를 발생시킵니다. EWKT 및 EWKB 처리에 대한 참고를 참고하세요.
  • WKT 또는 EWKT 입력에서 GEOGRAPHY 객체를 만들려면 ST_GEOGRAPHYFROMWKT를 사용할 수도 있습니다.
  • WKB 또는 EWKB 입력에서 GEOGRAPHY 객체를 만들려면 ST_GEOGRAPHYFROMWKB를 사용할 수도 있습니다.
  • WKT, EWKT, GeoJSON의 좌표에서 경도가 위도보다 먼저 옵니다(예: POINT(lon lat)).

예제 (Examples)

VARCHAR 데이터와 함께 TO_GEOGRAPHY 함수를 간단히 사용하는 예입니다:

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

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

다음 예제는 WKT 형식으로 설명된 Z 좌표가 있는 지리 공간 객체의 GEOGRAPHY 객체를 반환합니다:

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

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

더 알아보기 (Learn more)