st_z Función

Se aplica a: Databricks SQL Databricks Runtime 17.1 y versiones posteriores

Important

Esta característica está en versión preliminar pública.

Nota:

Esta característica no está disponible en almacenes clásicos de Databricks SQL. Para más información sobre los almacenes de SQL de Databricks, consulte Tipos de almacenamiento de SQL.

Devuelve la coordenada Z del valor del punto GEOMETRY de entrada o NULL si el punto está vacío o no tiene una coordenada Z.

Syntax

st_z ( geoExpr )

Arguments

• geoExpr: Un GEOMETRY valor.

Returns

Valor de tipo DOUBLE, igual a la coordenada Z del valor del punto GEOMETRY de entrada.

La función devuelve NULL si la entrada es NULL o si el punto está vacío.

Condiciones del error

• Si el valor de geoExpr no es un punto, la función devuelve 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

Funciones relacionadas

• st_m Función
• st_x Función
• st_y Función
• st_zmax Función
• st_zmin Función