共用方式為

to_geography函式

適用於：核取標示為是 Databricks SQL 核取標示為是 Databricks Runtime 17.1 和更新版本

Important

這項功能目前處於 公開預覽版。

備註

這項功能不適用於 Databricks SQL Classic 倉儲。 若要深入瞭解 Databricks SQL 倉儲，請參閱 SQL 倉儲類型。

剖析地理位置的輸入描述，並傳回對應的 GEOGRAPHY 值。 傳回 GEOGRAPHY 值的 SRID 值為 4326。

Syntax

to_geography ( geoRepExpr )

Arguments

  • geoRepExpr BINARY：或STRING表達式，代表 WKB、WKT 或 GeoJSON 中的地理位置。

Returns

GEOGRAPHY(ANY)型的值，與輸入的地理位置描述相對應。

如果輸入為 NULL，則函式會傳NULL回 。

錯誤條件

  • 如果 geoRepExpr 型別為 BINARY，且值是無效的 WKB，則函式會傳回 WKB_PARSE_ERROR。
  • 如果 geoRepExpr 的型別為 STRING，且其值為無效的 WKT，則函式會傳回 WKT_PARSE_ERROR。
  • 如果 geoRepExpr 型別為 STRING，且值為無效的 GeoJSON，則函式會傳回 GEOJSON_PARSE_ERROR。

Examples

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

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

-- Input geography is in WKB format.
> SELECT st_astext(to_geography(X'01b90b0000000000000000084000000000000010400000000000001440000000000000f0bf'))
  POINT ZM (3 4 5 -1)
  • Last updated on