st_x-Funktion

Gilt für: Databricks SQL 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 X-Koordinate des Eingabepunktwerts GEOMETRY zurück oder NULL wenn der Punkt leer ist.

Syntax

st_x ( geoExpr )

Arguments

• geoExpr: Ein GEOMETRY Wert.

Returns

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

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

Fehlerbedingungen

• Wenn der Wert von geoExpr kein Punkt ist, gibt die Funktion ST_INVALID_ARGUMENT.INVALID_TYPE zurück.

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

Zugehörige Funktionen

• st_m Funktion
• st_xmax Funktion
• st_xmin Funktion
• st_y Funktion
• st_z Funktion