카테고리:

지리 공간 함수, 변환 함수

ST_GEOMETRYFROMWKT

WKT (well-known text) 또는 EWKT (extended well-known text) 입력을 구문 분석하고 GEOMETRY 형식의 값을 반환합니다.

별칭:

ST_GEOMFROMWKT , ST_GEOMETRYFROMEWKT , ST_GEOMFROMEWKT , ST_GEOMETRYFROMTEXT , ST_GEOMFROMTEXT

참고 항목:

TO_GEOMETRY

구문

ST_GEOMETRYFROMWKT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMFROMWKT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMETRYFROMEWKT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMFROMEWKT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMETRYFROMTEXT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMFROMTEXT( <varchar_expression> [ , <srid> ] [ , <allow_invalid> ] )
Copy

인자

필수:

varchar_expression

인자는 유효한 지리 공간 오브젝트를 나타내는 WKT 또는 EWKT의 문자열 식이어야 합니다.

선택 사항:

srid

사용할 SRID의 정수 값입니다.

allow_invalid

TRUE인 경우 입력 도형이 유효하지 않고 복구할 수 없더라도 함수가 GEOGRAPHY 또는 GEOMETRY 오브젝트를 반환해야 하는 것으로 지정됩니다. 자세한 내용은 유효하지 않은 지리 공간 도형을 처리하는 방법 지정하기 섹션을 참조하십시오.

반환

함수는 GEOMETRY 형식의 값을 반환합니다.

사용법 노트

  • 입력을 WKT 또는 EWKT로 구문 분석할 수 없는 경우, 오류가 발생합니다.

  • WKT 입력의 경우 srid 인자가 지정되지 않으면 결과 GEOMETRY 오브젝트의 SRID가 0으로 설정됩니다.

예

다음 예는 EWKT 형식으로 설명된 지리 공간 오브젝트에 대한 GEOMETRY 오브젝트를 반환합니다.

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

SELECT ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)');
Copy
+---------------------------------------------------------------+
| ST_GEOMETRYFROMEWKT('SRID=32633;POINT(389866.35 5819003.03)') |
|---------------------------------------------------------------|
| SRID=32633;POINT(389866.35 5819003.03)                        |
+---------------------------------------------------------------+

다음 예는 EWKT 형식으로 설명된 Z축을 가진 지리 공간 오브젝트에 대한 GEOMETRY 오브젝트를 반환합니다.

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

SELECT ST_GEOMETRYFROMEWKT('SRID=32633;POINTZ(389866.35 5819003.03 30)');
Copy
+-------------------------------------------------------------------+
| ST_GEOMETRYFROMEWKT('SRID=32633;POINTZ(389866.35 5819003.03 30)') |
|-------------------------------------------------------------------|
| SRID=32633;POINTZ(389866.35 5819003.03 30)                        |
+-------------------------------------------------------------------+

다음 예에서 입력값은 WKT 형식이고 함수 호출에서는 사용할 SRID를 지정합니다.

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

SELECT ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)', 4326);
Copy
+----------------------------------------------------------+
| ST_GEOMETRYFROMWKT('POINT(389866.35 5819003.03)', 4326)  |
|----------------------------------------------------------|
| SRID=4326;POINT(389866.35 5819003.03)                    |
+----------------------------------------------------------+
언어: 한국어