funktion st_m

Gäller för: Databricks Databricks Runtime 17.1 och senare

Important

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Anmärkning

Den här funktionen är inte tillgänglig på de klassiska Databricks SQL-lagerhus. Mer information om Databricks SQL-lager finns i SQL-lagertyper.

Returnerar M-koordinaten för indatapunktsvärdet GEOMETRY , eller NULL om punkten är tom eller inte har en M-koordinat.

Syntax

st_m ( geoExpr )

Arguments

• geoExpr: Ett GEOMETRY värde.

Returns

Ett värde av typen DOUBLE, M-koordinat för indatapunkten GEOMETRY.

Funktionen returnerar NULL om indata är NULL eller om punkten är tom.

Feltillstånd

• Om värdet för geoExpr inte är en punkt returnerar funktionen 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

Relaterade funktioner

• st_x funktion
• st_y funktion
• st_z funktion