st_x Função

Aplica-se a: Databricks SQL Databricks Runtime 17.1 and above

Retorna a coordenada X do valor do ponto GEOMETRY de entrada ou NULL se o ponto está vazio.

Syntax

st_x ( geoExpr )

Arguments

• geoExpr: valor de GEOMETRY.

Returns

Um valor de tipo DOUBLE, igual à coordenada X do valor do ponto GEOMETRY de entrada.

A função retornará 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 X coordinate of a non-empty point geometry.
> SELECT st_x(st_geomfromtext('POINT Z (2 3 4)'));
  2.0
-- Returns `NULL` for an empty point geometry.
> SELECT st_x(st_geomfromtext('POINT ZM EMPTY'));
  NULL

Funções relacionadas

• st_m função
• st_xmax função
• st_xmin função
• st_y função
• st_z função