適用於：
Databricks SQL Databricks Runtime 17.1 和更新版本
Important
這項功能目前處於 公開預覽版。
備註
這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 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