적용 대상:
Databricks SQL
Databricks Runtime 17.1 이상으로 표시
Important
이 기능은 공개 미리보기 단계에 있습니다.
비고
이 기능은 Databricks SQL 클래식 웨어하우스에서 사용할 수 없습니다. Databricks SQL 웨어하우스에 대한 자세한 내용은 SQL 웨어하우스 유형을 참조하세요.
입력 지점 GEOMETRY 값의 M 좌표를 반환하거나 NULL 점이 비어 있거나 M 좌표가 없는 경우 반환합니다.
Syntax
st_m ( geoExpr )
Arguments
-
geoExpr:GEOMETRY값입니다.
Returns
DOUBLE 형식의 값, 입력 지점GEOMETRY의 M 좌표입니다.
함수는 입력이 NULL 비어 있거나 점이 비어 있는 경우 반환 NULL 됩니다.
오류 조건
- 값
geoExpr이 점이 아니면, 함수는 ST_INVALID_ARGUMENT.INVALID_TYPE을 반환합니다.
Examples
-- Returns the M coordinate of a non-empty point geometry with an M coordinate.
> SELECT st_m(st_geomfromtext('POINT M (2 3 4)'));
4.0
-- Returns the M coordinate of a non-empty point geometry without an M coordinate.
> SELECT st_m(st_geomfromtext('POINT Z (1 2 3)'));
NULL
-- Returns `NULL` for an empty point geometry.
> SELECT st_m(st_geomfromtext('POINT ZM EMPTY'));
NULL