ST_GEOMETRYFROMWKB¶
WKB (well-known binary) 또는 EWKB (extended well-known binary) 입력을 구문 분석하고 GEOMETRY 형식의 값을 반환합니다.
- 별칭:
ST_GEOMFROMWKB , ST_GEOMETRYFROMEWKB , ST_GEOMFROMEWKB
- 참고 항목:
구문¶
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 오브젝트를 반환해야 하는 것으로 지정됩니다. 자세한 내용은 유효하지 않은 지리 공간 도형을 처리하는 방법 지정하기 섹션을 참조하십시오.
사용법 노트¶
입력을 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) | +-------------------------------------------------------------------+