st_z Função

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

Retorna a coordenada Z do valor do ponto GEOMETRY de entrada ou NULL se o ponto está vazio ou não tem uma coordenada Z.

Syntax

st_z ( geoExpr )

Arguments

• geoExpr: valor de GEOMETRY.

Returns

Um valor de tipo DOUBLE, igual à coordenada Z 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 Z coordinate of a non-empty point geometry with a Z coordinate.
> SELECT st_z(st_geomfromtext('POINT Z (1 2 3)'));
  3.0
-- Returns the Z coordinate of a non-empty point geometry without a Z coordinate.
> SELECT st_z(st_geomfromtext('POINT M (2 3 4)'));
  NULL
-- Returns `NULL` for an empty point geometry.
> SELECT st_z(st_geomfromtext('POINT ZM EMPTY'));
  NULL

Funções relacionadas

• st_m função
• st_x função
• st_y função
• st_zmax função
• st_zmin função