카테고리:

지리 공간 함수, 변환 함수

TRY_TO_GEOMETRY

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

이 함수는 TO_GEOMETRY 와 동일합니다. 단, TO_GEOMETRY가 오류를 반환할 때 이 함수는 NULL을 반환합니다.

참고 항목:

TO_GEOMETRY

구문

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

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

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

TRY_TO_GEOMETRY( <variant_expression> [ , <srid> ] [ , <allow_invalid> ] )
Copy

인자

필수:

varchar_expression

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

  • WKT(well-known text).

  • 16진수 형식의 WKB(well-known binary)(선행 0x 제외).

  • EWKT(extended well-known text).

  • 16진수 형식의 EWKB(extended well-known binary)(선행 0x 제외).

  • GeoJSON.

binary_expression

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

variant_expression

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

선택 사항:

srid

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

allow_invalid

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

반환

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

사용법 노트

  • 입력을 지원되는 적절한 형식(WKT, WKB, EWKT, EWKB, GeoJSON)으로 구문 분석할 수 없는 경우, NULL을 반환합니다.

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

이는 VARCHAR 데이터가 있는 TRY_TO_GEOMETRY 함수의 간단한 사용법을 보여줍니다.

select try_to_geometry('INVALID INPUT');
Copy
+--------------------------------------+
| try_to_geometry('INVALID INPUT')     |
|--------------------------------------|
| NULL                                 |
+--------------------------------------+
Copy