Condividi tramite


Funzione try_to_geography

Si applica a:check contrassegnato come sì controllo SQL di Databricks contrassegnato come sì Databricks Runtime 17.1 e versioni successive

Important

Questa funzionalità è in Anteprima Pubblica.

Annotazioni

Questa funzionalità non è disponibile in Databricks SQL Classic Warehouses. Per altre informazioni sui databricks SQL Warehouse, vedere Tipi di SQL Warehouse.

Analizza la descrizione di input di un'area geografica e restituisce il valore corrispondente GEOGRAPHY oppure NULL se la descrizione di input non è valida. Il valore SRID del valore restituito GEOGRAPHY è 4326.

Syntax

try_to_geography ( geoRepExpr )

Arguments

  • geoRepExpr BINARY: espressione o STRING che rappresenta un'area geografica in WKB, WKT o GeoJSON.

Returns

Valore di tipo GEOGRAPHY(ANY), corrispondente alla descrizione geografica di input.

  • La funzione restituisce NULL se l'input è NULL.
  • La funzione restituisce NULL se il valore di input BINARY o STRING è una descrizione non valida di un'area geografica.

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