Teilen über

to_geometry-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 Geometrie und gibt den entsprechenden GEOMETRY Wert zurück. Der SRID-Wert des zurückgegebenen GEOMETRY Werts hängt vom Eingabeformat ab.

Syntax

to_geometry ( geoRepExpr )

Arguments

  • geoRepExpr: Ein BINARY oder STRING Ausdruck, der eine Geometrie in WKB, WKT, GeoJSON oder Extended WKB (EWKB) darstellt.

Returns

Ein Wert vom Typ GEOMETRY(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 EWKB ist, gibt die Funktion EWKB_PARSE_ERROR zurück.
  • 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 geometry is in WKT format.
> SELECT st_asgeojson(to_geometry('POINT Z (3 4 5)'));
  {"type":"Point","coordinates":[3,4,5]}

-- Input geometry is in GeoJSON format.
> SELECT st_astext(to_geometry('{"type":"Point","coordinates":[3,4,5]}'));
  POINT Z (3 4 5)

-- Input geometry is in WKB format.
> SELECT st_astext(to_geometry(X'0101000060110f0000000000000000084000000000000010400000000000001440'));
  POINT M (3 4 5)

-- Input geometry is in EWKB format.
> SELECT st_asewkt(to_geometry(X'01010000E0110F0000000000000000084000000000000010400000000000001440000000000000F0BF'));
  SRID=3857;POINT ZM (3 4 5 -1)
  • Last updated on