Teilen über


st_z-Funktion

Gilt für:check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Important

Dieses Feature befindet sich in der Public Preview.

Hinweis

Dieses Feature ist in Databricks SQL Classic Warehouses nicht verfügbar. Weitere Informationen zu Databricks SQL Warehouses finden Sie unter SQL Warehouse-Typen.

Gibt die Z-Koordinate des Eingabepunktwerts GEOMETRY zurück, oder NULL wenn der Punkt leer ist oder keine Z-Koordinate aufweist.

Syntax

st_z ( geoExpr )

Arguments

  • geoExpr: Ein GEOMETRY Wert.

Returns

Ein Wert vom Typ DOUBLE, gleich der Z-Koordinate des Eingabepunktwerts GEOMETRY .

Die Funktion gibt NULL zurück, wenn die Eingabe NULL ist oder der Punkt leer ist.

Fehlerbedingungen

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