Compartir a través de

to_geometry 函数

适用于：已勾选“是”的 Databricks Runtime 17.1 及更高版本

重要

此功能目前以公共预览版提供。

分析几何图形的输入说明并返回相应的 GEOMETRY 值。 返回 GEOMETRY 值的 SRID 值取决于输入格式。

语法

to_geometry ( geoRepExpr )

论据

  • geoRepExpr：表示 WKB、WKT、GeoJSON 或扩展 WKB（EWKB）中的几何图形的表达式BINARYSTRING。

退货

一个类型 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。

例子

-- 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)