Teilen über

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. Der SRID-Wert des zurückgegebenen GEOGRAPHY Werts ist 4326.

Syntax

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.

Fehlerbedingungen

  • Wenn geoRepExpr der Typ BINARY ist und der Wert eine ungültige WKB ist, gibt die Funktion WKB_PARSE_ERROR zurück.
  • Wenn geoRepExpr der Typ STRING ist und der Wert ein ungültiger WKT ist, gibt die Funktion WKT_PARSE_ERROR zurück.
  • Wenn geoRepExpr der Typ STRING ist und der Wert ein ungültiger GeoJSON-Wert ist, gibt die Funktion GEOJSON_PARSE_ERROR zurück.

Examples

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

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

-- Input geography is in WKB format.
> SELECT st_astext(to_geography(X'01b90b0000000000000000084000000000000010400000000000001440000000000000f0bf'))
  POINT ZM (3 4 5 -1)
  • Last updated on