共用方式為

to_geometry函式

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

Important

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

備註

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

剖析幾何的輸入描述，並傳回對應的 GEOMETRY 值。 傳回 GEOMETRY 值的 SRID 值取決於輸入格式。

Syntax

to_geometry ( geoRepExpr )

Arguments

  • geoRepExpr BINARY：或 STRING 表達式，代表 WKB、WKT、GeoJSON 或 Extended WKB （EWKB） 中的幾何。

Returns

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

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

錯誤條件

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

Examples

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

-- Input geometry is in GeoJSON format.
> SELECT st_astext(to_geometry('{"type":"Point","coordinates":[3,4,5]}'));
  POINT Z (3 4 5)

-- Input geometry is in WKB format.
> SELECT st_astext(to_geometry(X'0101000060110f0000000000000000084000000000000010400000000000001440'));
  POINT M (3 4 5)

-- Input geometry is in EWKB format.
> SELECT st_asewkt(to_geometry(X'01010000E0110F0000000000000000084000000000000010400000000000001440000000000000F0BF'));
  SRID=3857;POINT ZM (3 4 5 -1)
  • Last updated on