Teilen über

try_to_geography-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.

Analysiert die Eingabebeschreibung einer Geografie und gibt den entsprechenden GEOGRAPHY Wert zurück oder NULL wenn die Eingabebeschreibung ungültig ist. Der SRID-Wert des zurückgegebenen GEOGRAPHY Werts ist 4326.

Syntax

try_to_geography ( geoRepExpr )

Arguments

  • geoRepExpr: Ein BINARY oder STRING Ausdruck, der eine Geografie in WKB, WKT oder GeoJSON darstellt.

Returns

Ein Wert vom Typ GEOGRAPHY(ANY), der der Beschreibung der Eingabegeografie entspricht.

  • Die Funktion gibt zurück NULL , wenn die Eingabe lautet NULL.
  • Die Funktion gibt NULL zurück, wenn entweder BINARY oder STRING ein ungültiger Wert für die Beschreibung einer Geografie ist.

Examples

-- Input geography is in WKT format.
> SELECT st_asgeojson(try_to_geography('POINT Z (3 4 5)'));
  {"type":"Point","coordinates":[3,4,5]}

-- Input geography is in GeoJSON format.
> SELECT st_asewkt(try_to_geography('{"type":"Point","coordinates":[3,4,5]}'));
  SRID=4326;POINT Z (3 4 5)

-- Input geography is in WKB format.
> SELECT st_astext(try_to_geography(X'01b90b0000000000000000084000000000000010400000000000001440000000000000f0bf'))
  POINT ZM (3 4 5 -1)

-- Input value is not the description of a geography.
> SELECT st_astext(try_to_geography('some string that does not represent a geography'))
  NULL
  • Last updated on