ST_GEOMETRYFROMWKB

ST_GEOMETRYFROMWKB (WKB/EWKB 파싱)

WKB(well-known binary) 또는 EWKB(extended well-known binary) 입력을 파싱해 GEOMETRY 타입 값을 반환해요.

별칭: ST_GEOMFROMWKB, ST_GEOMETRYFROMEWKB, ST_GEOMFROMEWKB

출처: Snowflake SQL Reference - ST_GEOMETRYFROMWKB

본문

구문

ST_GEOMETRYFROMWKB( <varchar_or_binary_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMFROMWKB( <varchar_or_binary_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMETRYFROMEWKB( <varchar_or_binary_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMFROMEWKB( <varchar_or_binary_expression> [ , <srid> ] [ , <allow_invalid> ] )

인자

필수:

varchar_or_binary_expression

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

문자열 표현식은 16진수 형식이어야 해요(앞의 0x 없이).

선택:

srid

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

allow_invalid

TRUE이면 입력 모양이 유효하지 않고 복구할 수 없을 때도 함수가 GEOGRAPHY 또는 GEOMETRY 객체를 반환함을 지정해요. 자세한 내용은 유효하지 않은 지리 공간 모양이 처리되는 방식 지정을 참고하세요.

반환 값

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

사용 시 참고 사항

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

예시

다음 예시는 EWKB 형식으로 기술된 지리 공간 객체에 대한 GEOMETRY 객체를 반환해요.

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

SELECT ST_GEOMETRYFROMEWKB('0101000020797F000066666666A9CB17411F85EBC19E325641');

+---------------------------------------------------------------------------+
| ST_GEOMETRYFROMEWKB('0101000020797F000066666666A9CB17411F85EBC19E325641') |
|---------------------------------------------------------------------------|
| SRID=32633;POINT(389866.35 5819003.03)                                     |
+---------------------------------------------------------------------------+

다음 예시에서 입력은 SRID를 지정하지 않는 WKB 형식이에요.

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

SELECT ST_GEOMETRYFROMEWKB('010100000066666666A9CB17411F85EBC19E325641');

+-------------------------------------------------------------------+
| ST_GEOMETRYFROMEWKB('010100000066666666A9CB17411F85EBC19E325641') |
|-------------------------------------------------------------------|
| SRID=0;POINT(389866.35 5819003.03)                                |
+-------------------------------------------------------------------+

ST_GEOMETRYFROMWKB