適用対象:
Databricks SQL
Databricks Runtime 17.1 以降" とマークされているチェック
Important
この機能は パブリック プレビュー段階です。
注
この機能は、Databricks SQL クラシック ウェアハウスでは使用できません。 Databricks SQL ウェアハウスの詳細については、 SQL ウェアハウスの種類に関するページを参照してください。
入力ポイントの M 座標 GEOMETRY 値を返します。ポイントが空の場合、または M 座標がない場合は NULL します。
Syntax
st_m ( geoExpr )
Arguments
-
geoExpr:GEOMETRY値。
Returns
DOUBLE型の値、入力ポイントの M 座標GEOMETRY。
この関数は、入力が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