try_to_geography Funkce

Platí pro:check označený jako ano Kontrola SQL Databricks označená jako ano Databricks Runtime 17.1 a vyšší

Important

Tato funkce je ve verzi Public Preview.

Poznámka:

Tato funkce není k dispozici ve skladech Databricks SQL Classic. Další informace o službě Databricks SQL Warehouse najdete v tématu Typy SQL Warehouse.

Analyzuje vstupní popis zeměpisu a vrátí odpovídající GEOGRAPHY hodnotu nebo NULL je-li vstupní popis neplatný. Hodnota SRID vrácené GEOGRAPHY hodnoty je 4326.

Syntax

try_to_geography ( geoRepExpr )

Arguments

Returns

Hodnota typu GEOGRAPHY(ANY)odpovídající popisu vstupní zeměpisné oblasti.

  • Funkce vrátí NULL , pokud je NULLvstup .
  • Funkce vrátí NULL , pokud je vstup BINARY nebo STRING hodnota neplatným popisem zeměpisné oblasti.

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 geometry is in EWKT format.
> SELECT concat_ws(';', st_srid(g)::STRING, st_asgeojson(g)) FROM (SELECT try_to_geography('SRID=4326;POINT Z (3 4 5)') AS g);
  4326;{"type":"Point","coordinates":[3,4,5]}

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