通过

st_geomfromtext 函数

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

重要

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

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

语法

st_geomfromtext ( wktExpr[, sridExpr] )

论据

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

退货

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

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

错误条件

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

例子

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

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