14.16.4 Functions That Create Geometry Values from WKB Values

14.16.4 WKB 값으로부터 Geometry 값을 생성하는 함수

이들 함수는 Well-Known Binary (WKB) 표현을 포함하는 BLOB과 (선택적으로) 공간 참조 시스템 식별자(SRID)를 인수로 사용합니다. 이 함수들은 해당 geometry를 반환합니다. WKB 형식에 대한 설명은 Well-Known Binary (WKB) Format을 참조하십시오.

이 절의 함수들은 Cartesian 또는 지리적 공간 참조 시스템 (SRS) 중 어느 쪽이든 인수를 감지하고, 해당 SRS에 적합한 결과를 반환합니다.

ST_GeomFromWKB()는 첫 번째 인수로 어떤 geometry 타입이든 WKB 값을 허용합니다. 다른 함수들은 각 geometry 타입의 geometry 값을 구성하기 위한 타입별 생성 함수를 제공합니다.

MySQL 9.5 이전에는, 이들 함수는 또한 Section 14.16.5, “MySQL-Specific Functions That Create Geometry Values”의 함수들이 반환하는 geometry 객체도 허용했습니다. Geometry 인수는 더 이상 허용되지 않으며 오류를 발생시킵니다. Geometry 인수를 사용하던 호출을 WKB 인수를 사용하도록 마이그레이션하려면 다음 가이드를 따르십시오:

• ST_GeomFromWKB(Point(0, 0))과 같은 구문을 Point(0, 0)으로 다시 작성합니다.

• ST_GeomFromWKB(Point(0, 0), 4326)과 같은 구문을 ST_SRID(Point(0, 0), 4326) 또는 ST_GeomFromWKB(ST_AsWKB(Point(0, 0)), 4326)으로 다시 작성합니다.

별도로 명시되지 않는 한, 이 절의 함수들은 geometry 인수를 다음과 같이 처리합니다:

• WKB 또는 SRID 인수가 NULL이면, 반환 값은 NULL입니다.

• 기본적으로, 지리 좌표(latitude, longitude)는 geometry 인수의 공간 참조 시스템에 의해 지정된 순서대로 해석됩니다. 기본 축 순서를 재정의하기 위해 선택적인 options 인수를 지정할 수 있습니다. options는 쉼표로 구분된 key=value 목록으로 구성됩니다. 허용되는 key 값은 axis-order 하나이며, 허용되는 값은 lat-long, long-lat, srid-defined(기본값)입니다.

  options 인수가 NULL이면, 반환 값은 NULL입니다. options 인수가 유효하지 않으면, 그 이유를 나타내는 오류가 발생합니다.

• SRID 인수가 정의되지 않은 공간 참조 시스템(SRS)을 참조하는 경우, ER_SRS_NOT_FOUND 오류가 발생합니다.

• 지리 SRS geometry 인수의 경우, 어떤 인수든 경도 또는 위도가 허용 범위를 벗어나면 오류가 발생합니다:

  • 경도 값이 범위 (−180, 180]에 있지 않으면, ER_LONGITUDE_OUT_OF_RANGE 오류가 발생합니다.

  • 위도 값이 범위 [−90, 90]에 있지 않으면, ER_LATITUDE_OUT_OF_RANGE 오류가 발생합니다.

  표시된 범위는 도 단위입니다. SRS가 다른 단위를 사용하는 경우, 범위는 해당 단위의 값으로 사용됩니다. 정확한 범위 한계는 부동소수점 연산으로 인해 약간 벗어날 수 있습니다.

다음 함수들은 WKB 값으로부터 geometry를 생성하는 데 사용할 수 있습니다:

• ST_GeomCollFromWKB(wkb [, srid [, options]]), ST_GeometryCollectionFromWKB(wkb [, srid [, options]])

  WKB 표현과 SRID를 사용하여 GeometryCollection 값을 구성합니다.

  이 함수들은 이 절의 서론에 설명된 대로 인수를 처리합니다.

• ST_GeomFromWKB(wkb [, srid [, options]]), ST_GeometryFromWKB(wkb [, srid [, options]])

  WKB 표현과 SRID를 사용하여 임의 타입의 geometry 값을 구성합니다.

  이 함수들은 이 절의 서론에 설명된 대로 인수를 처리합니다.

• ST_LineFromWKB(wkb [, srid [, options]]), ST_LineStringFromWKB(wkb [, srid [, options]])

  WKB 표현과 SRID를 사용하여 LineString 값을 구성합니다.

  이 함수들은 이 절의 서론에 설명된 대로 인수를 처리합니다.

• ST_MLineFromWKB(wkb [, srid [, options]]), ST_MultiLineStringFromWKB(wkb [, srid [, options]])

  WKB 표현과 SRID를 사용하여 MultiLineString 값을 구성합니다.

  이 함수들은 이 절의 서론에 설명된 대로 인수를 처리합니다.

• ST_MPointFromWKB(wkb [, srid [, options]]), ST_MultiPointFromWKB(wkb [, srid [, options]])

  WKB 표현과 SRID를 사용하여 MultiPoint 값을 구성합니다.

  이 함수들은 이 절의 서론에 설명된 대로 인수를 처리합니다.

• ST_MPolyFromWKB(wkb [, srid [, options]]), ST_MultiPolygonFromWKB(wkb [, srid [, options]])

  WKB 표현과 SRID를 사용하여 MultiPolygon 값을 구성합니다.

  이 함수들은 이 절의 서론에 설명된 대로 인수를 처리합니다.

• ST_PointFromWKB(wkb [, srid [, options]])

  WKB 표현과 SRID를 사용하여 Point 값을 구성합니다.

  ST_PointFromWKB()는 이 절의 서론에 설명된 대로 인수를 처리합니다.

• ST_PolyFromWKB(wkb [, srid [, options]]), ST_PolygonFromWKB(wkb [, srid [, options]])

  WKB 표현과 SRID를 사용하여 Polygon 값을 구성합니다.

  이 함수들은 이 절의 서론에 설명된 대로 인수를 처리합니다.