st_geomfromwkb 函数

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

重要

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

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

语法

st_geomfromwkb ( wkbExpr[, sridExpr] )

论据

  • wkbExpr:一个 BINARY 值,表示 WKB 格式的几何图形。
  • sridExpr:一个可选的 INTEGER 值,此值被设置为返回的 GEOMETRY 值的 SRID。

退货

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

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

错误条件

  • 如果值为 wkbExpr 无效的 WKB 说明,则函数将返回 WKB_PARSE_ERROR
  • 如果不支持该值 sridExpr ,则函数返回 ST_INVALID_SRID_VALUE

例子

-- Simple example where we do not specify the output SRID. It defaults to 0. Input is in little-endian format.
> SELECT st_asewkt(st_geomfromwkb(X'01D1070000000000000000244000000000000041400000000000003740'))
  POINT M (10 34 23)

-- Simple example where we do not specify the output SRID. It defaults to 0. Input is in big-endian format.
> SELECT st_asewkt(st_geomfromwkb(X'00000007D1402400000000000040410000000000004037000000000000'))
  POINT M (10 34 23)

-- Simple example where we specify the SRID value for the output.
> SELECT st_asewkt(st_geomfromwkb(X'01D1070000000000000000244000000000000041400000000000003740', 3857))
  SRID-3857;POINT M (10 34 23)