Delen via


try_to_geometry functie

Van toepassing op:controleren gemarkeerd ja Databricks SQL-controle gemarkeerd als ja Databricks Runtime 17.1 en hoger

Important

Deze functie bevindt zich in openbare preview-versie.

Opmerking

Deze functie is niet beschikbaar in Databricks SQL Classic Warehouses. Zie SQL Warehouse-typen voor meer informatie over Databricks SQL-warehouses.

Parseert de invoerbeschrijving van een geometrie en retourneert de bijbehorende GEOMETRY waarde, of NULL als de invoerbeschrijving ongeldig is. De SRID-waarde van de geretourneerde GEOMETRY waarde is afhankelijk van de invoerindeling.

Syntax

try_to_geometry ( geoRepExpr )

Arguments

  • geoRepExpr: A BINARY of STRING expressie die een geometrie vertegenwoordigt in WKB, WKT, GeoJSON of Extended WKB (EWKB).

Returns

Een waarde van het type GEOMETRY(ANY), die overeenkomt met de beschrijving van de invoergeometrie.

  • De functie retourneert NULL als de invoer is NULL.
  • De functie retourneert NULL als de invoer BINARY of STRING waarde een ongeldige beschrijving van een geometrie is.

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