ST_GEOGRAPHYFROMWKB

ST_GEOGRAPHYFROMWKB

WKB(well-known binary) 또는 EWKB(extended well-known binary) 입력을 구문 분석하고 GEOGRAPHY 타입의 값을 반환해요.

출처: Snowflake ST_GEOGRAPHYFROMWKB 함수 문서

본문

별칭: ST_GEOGFROMWKB, ST_GEOGRAPHYFROMEWKB, ST_GEOGFROMEWKB

참고 항목: TO_GEOGRAPHY

구문 (Syntax)

ST_GEOGRAPHYFROMWKB(  [ ,  ] )

ST_GEOGFROMWKB(  [ ,  ] )

ST_GEOGRAPHYFROMEWKB(  [ ,  ] )

ST_GEOGFROMEWKB(  [ ,  ] )

인자 (Arguments)

필수:

  • varchar_or_binary_expression — 인자는 유효한 지리공간 객체를 나타내는 WKB 또는 EWKB의 문자열 또는 이진 표현식이어야 해요. 문자열 표현식은 16진수 형식(선행 0x 없이)이어야 해요.

선택:

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

반환 값 (Returns)

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

사용 노트 (Usage Notes)

  • 입력을 WKB 또는 EWKB로 구문 분석할 수 없으면 오류를 발생시켜요.
  • 입력 형식이 EWKB이고 SRID가 4326이 아니면 오류를 발생시켜요. EWKT 및 EWKB 처리에 대한 참고 사항을 참고해요.

예제 (Examples)

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

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

select ST_GEOGRAPHYFROMWKB('01010000006666666666965EC06666666666C64240');
+-------------------------------------------------------------------+
| ST_GEOGRAPHYFROMWKB('01010000006666666666965EC06666666666C64240') |
|-------------------------------------------------------------------|
| POINT(-122.35 37.55)                                              |
+-------------------------------------------------------------------+

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

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

select ST_GEOGRAPHYFROMEWKB('0101000020E61000006666666666965EC06666666666C64240');
+----------------------------------------------------------------------------+
| ST_GEOGRAPHYFROMEWKB('0101000020E61000006666666666965EC06666666666C64240') |
|----------------------------------------------------------------------------|
| SRID=4326;POINT(-122.35 37.55)                                             |
+----------------------------------------------------------------------------+

더 알아보기