카테고리:

지리공간 함수, 변환 함수

TO_GEOMETRY

입력을 구문 분석하고 GEOMETRY 형식의 값을 반환합니다.

참고 항목:

TRY_TO_GEOMETRY , ST_GEOMETRYFROMWKB , ST_GEOMETRYFROMWKT

구문

다음 중 하나를 사용하십시오.

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

TO_GEOMETRY( <binary_expression> [ , <srid> ] [ , <allow_invalid> ] )

TO_GEOMETRY( <variant_expression> [ , <srid> ] [ , <allow_invalid> ] )

TO_GEOMETRY( <geography_expression> [ , <srid> ] [ , <allow_invalid> ] )
Copy

인자

필수:

varchar_expression

인자는 다음 형식 중 하나로 유효한 기하학적 오브젝트를 나타내는 문자열 식이어야 합니다.

  • WKT(잘 알려진 텍스트)

  • 16진수 형식의 WKB(잘 알려진 바이너리)(선행 0x 제외)

  • EWKT(확장된 잘 알려진 텍스트)

  • 16진수 형식의 EWKB(확장된 잘 알려진 바이너리)(선행 0x 제외)

  • GeoJSON

binary_expression

인자는 WKB 또는 EWKB 형식의 이진 식이어야 합니다.

variant_expression

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

geography_expression

인자는 GEOGRAPHY 형식의 식이어야 합니다.

선택 사항:

srid

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

allow_invalid

TRUE인 경우 입력 형태가 유효하지 않고 복구할 수 없는 경우에도 함수가 GEOGRAPHY 또는 GEOMETRY 오브젝트를 반환하도록 지정합니다. 자세한 내용은 유효하지 않은 지리 공간 도형을 처리하는 방법 지정하기 섹션을 참조하세요.

반환

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

사용법 노트

  • 지원되는 형식(WKT, WKB, EWKT, EWKB, GeoJSON) 중 하나로 입력을 구문 분석할 수 없는 경우, 오류가 발생합니다.

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

  • WKT 또는 EWKT 입력에서 GEOMETRY 오브젝트를 구성하려면 ST_GEOMETRYFROMWKT 를 사용할 수도 있습니다.

  • WKB 또는 EWKB 입력에서 GEOMETRY 오브젝트를 구성하려면 ST_GEOMETRYFROMWKB 를 사용할 수도 있습니다.

다음 예제에서는 TO_GEOMETRY 함수를 사용하여 WKT에 표시된 오브젝트를 GEOMETRY 오브젝트로 변환하는 방법을 보여줍니다. 이 예제에서는 srid 인자를 지정하지 않으며 SRID는 오브젝트의 입력 표현에 지정되지 않으므로 SRID가 0 으로 설정됩니다.

ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT TO_GEOMETRY('POINT(1820.12 890.56)');
Copy
+--------------------------------------+
| TO_GEOMETRY('POINT(1820.12 890.56)') |
|--------------------------------------|
| SRID=0;POINT(1820.12 890.56)         |
+--------------------------------------+

다음 예제에서는 EWKT로 표시된 오브젝트를 GEOMETRY 오브젝트로 변환합니다. 입력 EKWT는 사용할 SRID를 지정합니다.

ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT TO_GEOMETRY('SRID=4326;POINT(1820.12 890.56)');
Copy
+------------------------------------------------+
| TO_GEOMETRY('SRID=4326;POINT(1820.12 890.56)') |
|------------------------------------------------|
| SRID=4326;POINT(1820.12 890.56)                |
+------------------------------------------------+

다음 예제에서는 SRID를 srid 입력 인자로 지정하는 방법을 보여줍니다.

ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT TO_GEOMETRY('POINT(1820.12 890.56)', 4326);
Copy
+--------------------------------------------+
| TO_GEOMETRY('POINT(1820.12 890.56)', 4326) |
|--------------------------------------------|
| SRID=4326;POINT(1820.12 890.56)            |
+--------------------------------------------+

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

ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

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

GEOGRAPHY 오브젝트를 GEOMETRY 오브젝트로 변환하는 예는 GEOGRAPHY와 GEOMETRY 간에 변환하기 섹션을 참조하십시오.

다음 예제에서는 테이블의 데이터에 대한 쿼리에 TO_GEOMETRY 함수를 사용합니다.

임시 테이블을 만들고 GEOMETRY 값이 포함된 행을 삽입합니다.

CREATE OR REPLACE TEMP TABLE demo_to_geometry AS
SELECT
  1                                                     AS id,
  'POINT(10 20)'                                        AS wkt_col,         -- VARCHAR (WKT)
  'SRID=32633;POINT(500000.0 4649776.22)'               AS ewkt_col,        -- VARCHAR (EWKT)
  ST_ASWKB(TO_GEOMETRY('LINESTRING(0 0, 1 1)'))         AS wkb_bin_col,     -- BINARY (WKB)
  PARSE_JSON('{"type":"Point","coordinates":[10,20]}')  AS geojson_col,     -- VARIANT (GeoJSON)
  TO_GEOGRAPHY('POINT(-122.35 37.55)')                  AS geog_col,        -- GEOGRAPHY
  'POLYGON((0 0,2 2,2 0,0 2,0 0))'                      AS invalid_wkt_col, -- invalid shape
  0                                                     AS srid0,           -- SRID columns to show positional args
  3857                                                  AS srid_col,
  TRUE                                                  AS allow_true,      -- allow_invalid flags from columns
  FALSE                                                 AS allow_false
UNION ALL
SELECT
  2,
  'LINESTRING(0 0, 10 10)',
  'SRID=32633;POINT(389866.35 5819003.03)',
  ST_ASWKB(TO_GEOMETRY('POINT(2 3)')),
  PARSE_JSON('{"type":"LineString","coordinates":[[0,0],[1,1]]}'),
  TO_GEOGRAPHY('LINESTRING(-124.2 42,-120.01 41.99)'),
  'POLYGON((0 0,1 1,1 0,0 1,0 0))',
  0,
  3857,
  TRUE,
  FALSE;
Copy

이 테이블에는 TO_GEOMETRY 함수가 다음 형식의 입력으로 수락하는 데이터 타입의 열이 있습니다.

  • VARCHAR(WKT/WKB 및 hex/EWKT/EWKB/GeoJSON)

  • BINARY(WKB/EWKB)

  • VARIANT(GeoJSON 오브젝트)

  • GEOGRAPHY

선택적 sridallow_invalid 값은 이러한 형식을 따를 수 있습니다. ST_ASWKB , ST_ASBINARY 함수는 유효한 WKB BINARY 값을 생성합니다.

다음 예제에서는 기본 SRID 0 을 사용하여 wkt_col 열의 VARCHAR 값을 대상으로 GEOMETRY 값으로 변환합니다.

ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT id, TO_GEOMETRY(wkt_col) AS g
  FROM demo_to_geometry;
Copy
+----+------------------------------+
| ID | G                            |
|----+------------------------------|
|  1 | SRID=0;POINT(10 20)          |
|  2 | SRID=0;LINESTRING(0 0,10 10) |
+----+------------------------------+

다음 예제에서는 srid_col 열의 SRID 값을 사용하여 wkt_col 열의 VARCHAR 값을 대상으로 GEOMETRY 값으로 변환합니다.

ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT id, TO_GEOMETRY(wkt_col, srid_col) AS g
  FROM demo_to_geometry;
Copy
+----+----------------------------------+
| ID | G                                |
|----+----------------------------------|
|  1 | SRID=3857;POINT(10 20)           |
|  2 | SRID=3857;LINESTRING(0 0,10 10)  |
+----+----------------------------------+

다음 예제에서는 ewkt_col 열 값에 포함된 SRID 값을 사용하여 ewkt_col 열의 VARCHAR 값을 대상으로 GEOMETRY 값으로 변환합니다.

ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT id, TO_GEOMETRY(ewkt_col) AS g
  FROM demo_to_geometry;
Copy
+----+--------------------------------------------+
| ID | G                                          |
|----+--------------------------------------------|
|  1 | SRID=32633;POINT(500000 4649776.22)        |
|  2 | SRID=32633;POINT(389866.35 5819003.03)     |
+----+--------------------------------------------+

다음 예제에서는 wkb_bin_col 열의 BINARY 값을 대상으로 GEOMETRY 값으로 변환합니다.

ALTER SESSION SET BINARY_OUTPUT_FORMAT='HEX';

SELECT id, TO_GEOMETRY(wkb_bin_col) AS g
  FROM demo_to_geometry;
Copy
+----+----------------------------+
| ID | G                          |
|----+----------------------------|
|  1 | SRID=0;LINESTRING(0 0,1 1) |
|  2 | SRID=0;POINT(2 3)          |
+----+----------------------------+

다음 예제에서는 srid_col 열의 SRID 값을 사용하여 geojson_col 열의 VARIANT 값을 대상으로 GEOMETRY 값으로 변환합니다.

ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT id, TO_GEOMETRY(geojson_col, srid_col) AS g
  FROM demo_to_geometry;
Copy
+----+--------------------------------+
| ID | G                              |
|----+--------------------------------|
|  1 | SRID=3857;POINT(10 20)         |
|  2 | SRID=3857;LINESTRING(0 0,1 1)  |
+----+--------------------------------+

다음 예제에서는 srid_col 열의 SRID 값을 사용하여 geog_col 열의 GEOGRAPHY 값을 대상으로 GEOMETRY 값으로 변환합니다.

ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT id, TO_GEOMETRY(geog_col, srid_col) AS g
  FROM demo_to_geometry;
Copy
+----+-----------------------------------------------+
| ID | G                                             |
|----+-----------------------------------------------|
|  1 | SRID=4326;POINT(-122.35 37.55)                |
|  2 | SRID=4326;LINESTRING(-124.2 42,-120.01 41.99) |
+----+-----------------------------------------------+

다음 예제에서는 srid0 열의 SRID 값(0)과 allow_true 열의 allow_invalid 값을 사용하여 invalid_wkt_col 열의 VARCHAR 값을 GEOMETRY 값으로 변환합니다.

ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT id, TO_GEOMETRY(invalid_wkt_col, srid0, allow_true) AS g
  FROM demo_to_geometry;
Copy

출력에 유효하지 않은 형태가 포함됩니다.

+----+---------------------------------------+
| ID | G                                     |
|----+---------------------------------------|
|  1 | SRID=0;POLYGON((0 0,2 2,2 0,0 2,0 0)) |
|  2 | SRID=0;POLYGON((0 0,1 1,1 0,0 1,0 0)) |
+----+---------------------------------------+