try_to_geometry-Funktion

Gilt für: Databricks SQL Databricks Runtime 17.1 and above

Analysiert die Eingabebeschreibung einer Geometrie und gibt den entsprechenden GEOMETRY Wert zurück oder NULL wenn die Eingabebeschreibung ungültig ist. Der SRID-Wert des zurückgegebenen GEOMETRY Werts hängt vom Eingabeformat ab.

Syntax

try_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 Eingabegeometriebeschreibung entspricht.

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

Examples

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

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

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

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

-- Input value is not the description of a geometry.
> SELECT st_astext(try_to_geometry('some string that does not represent a geometry'))
  NULL

Zugehörige Funktionen

• st_asbinary Funktion
• st_asewkb Funktion
• st_asewkt Funktion
• st_asgeojson Funktion
• st_astext Funktion
• st_aswkb Funktion
• st_aswkt Funktion
• st_geogfromgeojson Funktion
• st_geogfromtext Funktion
• st_geogfromwkb Funktion
• st_geogfromwkt Funktion
• st_geomfromewkb Funktion
• st_geomfromgeojson Funktion
• st_geomfromtext Funktion
• st_geomfromwkb Funktion
• st_geomfromwkt Funktion
• to_geography Funktion
• to_geometry Funktion
• try_to_geography Funktion