Skip to main content

try_to_geometry function

Applies to: check marked yes Databricks SQL check marked yes Databricks Runtime 17.1 and above

Preview

This feature is in Public Preview.

note

This feature is not available on Databricks SQL Classic warehouses. To learn more about Databricks SQL warehouses, see SQL warehouse types

Parses the input description of a geometry and returns the corresponding GEOMETRY value, or NULL if the input description is invalid. The SRID value of the returned GEOMETRY value depends on the input format.

Syntax​

try_to_geometry ( geoRepExpr )

Arguments​

  • geoRepExpr: A BINARY or STRING expression representing a geometry in WKB, WKT, GeoJSON, or Extended WKB (EWKB).

Returns​

A value of type GEOMETRY(ANY), corresponding to the input geometry description.

  • The function returns NULL if the input is NULL.
  • The function returns NULL if the input BINARY or STRING value is an inalid description of a geometry.

Examples​

SQL
-- 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
Last updated on