funktion try_to_geometry

Gäller för:check markerad ja Databricks SQL-kontroll markerad ja Databricks Runtime 17.1 och senare

Important

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Anmärkning

Den här funktionen är inte tillgänglig på de klassiska Databricks SQL-lagerhus. Mer information om Databricks SQL-lager finns i SQL-lagertyper.

Parsar indatabeskrivningen för en geometri och returnerar motsvarande GEOMETRY värde, eller NULL om indatabeskrivningen är ogiltig. SRID-värdet för det returnerade GEOMETRY värdet beror på indataformatet.

Syntax

try_to_geometry ( geoRepExpr )

Arguments

  • geoRepExpr: Ett BINARY eller STRING -uttryck som representerar en geometri i WKB, WKT, GeoJSON eller Extended WKB (EWKB).

Returns

Ett värde av typen GEOMETRY(ANY), som motsvarar beskrivningen av indatageometrin.

  • Funktionen returnerar NULL om indata är NULL.
  • Funktionen returnerar NULL om indata BINARY eller STRING värde är en ogiltig beskrivning av en geometri.

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