st_m Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 e superior

Retorna a coordenada M do valor do ponto GEOMETRY de entrada ou NULL se o ponto estiver vazio ou não tiver uma coordenada M.

Syntax

st_m ( geoExpr )

Arguments

• geoExpr: Um GEOMETRY valor.

Returns

Um valor do tipo DOUBLE, coordenada M do ponto GEOMETRYde entrada.

A função retorna NULL se a entrada estiver NULL ou se o ponto estiver vazio.

Condições de erro

• Se o valor de geoExpr não for um ponto, a função retornará 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

Funções relacionadas

• st_x Função
• st_y Função
• st_z Função