funktion try_to_geography

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 ett geografiskt område och returnerar motsvarande GEOGRAPHY värde, eller NULL om indatabeskrivningen är ogiltig. SRID-värdet för det returnerade GEOGRAPHY värdet är 4326.

Syntax

try_to_geography ( geoRepExpr )

Arguments

  • geoRepExpr: Ett BINARY eller STRING ett uttryck som representerar ett geografiskt område i WKB, WKT eller GeoJSON.

Returns

Ett värde av typen GEOGRAPHY(ANY), som motsvarar beskrivningen av indatageografin.

  • Funktionen returnerar NULL om indata är NULL.
  • Funktionen returnerar NULL om indata BINARY eller STRING värde är en ogiltig beskrivning av ett geografiskt område.

Examples

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

-- Input geography is in GeoJSON format.
> SELECT st_asewkt(try_to_geography('{"type":"Point","coordinates":[3,4,5]}'));
  SRID=4326;POINT Z (3 4 5)

-- Input geography is in WKB format.
> SELECT st_astext(try_to_geography(X'01b90b0000000000000000084000000000000010400000000000001440000000000000f0bf'))
  POINT ZM (3 4 5 -1)

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