通过

st_geomfromwkt 函数

适用于：检查标记为“是”的 Databricks SQL 检查标记为“是”是 Databricks Runtime 17.1 及更高版本

Important

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

注释

此功能在 Databricks SQL 经典仓库上不可用。 若要详细了解 Databricks SQL 仓库，请参阅 SQL 仓库类型。

分析几何图形的 WKT 说明并返回相应的 GEOMETRY 值。 返回 GEOMETRY 值的 SRID 值是指定的值 sridExpr ，否则为 0。

Syntax

st_geomfromwkt ( wktExpr[, sridExpr] )

Arguments

  • wktExpr：一个 STRING 值，表示 WKT 格式的几何图形。
  • sridExpr：一个可选的 INTEGER 值，此值被设置为返回的 GEOMETRY 值的 SRID。

Returns

GEOMETRY(srid) 类型的值，其中，如果 srid 是常量（可折叠）表达式，则 sridExpr 是 sridExpr 的值，否则为 GEOMETRY(ANY)。 如果 sridExpr 省略返回值的类型为 GEOMETRY(0)。 返回的值是对应于输入 WKT 说明的几何图形。

如果任何输入为NULL，该函数将返回NULL。

错误条件

  • 如果 wktExpr 的值为无效的 WKT 说明，则函数将返回 WKT_PARSE_ERROR。
  • 如果不支持该值 sridExpr ，则函数返回 ST_INVALID_SRID_VALUE。

Examples

-- Simple example where we do not specify the output SRID. It defaults to 0.
> SELECT st_srid(st_geomfromwkt('POINT Z (1 2 3)'));
  0

-- Simple example where we specify the SRID value for the output.
> SELECT st_asewkt(st_geomfromwkt('POINT Z (1 2 3)', 3857));
  SRID=3857;POINT Z (1 2 3)