st_z Função

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

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

Syntax

st_z ( geoExpr )

Arguments

• geoExpr: Um GEOMETRY valor.

Returns

Um valor do tipo DOUBLE, igual à coordenada Z do valor do ponto GEOMETRY de 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 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