适用于: Databricks Runtime 17.1 及更高版本
重要
此功能目前以公共预览版提供。
分析几何图形的 WKB 说明并返回相应的 GEOMETRY
值。
返回 GEOMETRY
值的 SRID 值是指定的值 sridExpr
,否则为 0。
语法
st_geomfromwkb ( wkbExpr[, sridExpr] )
论据
-
wkbExpr
:一个BINARY
值,表示 WKB 格式的几何图形。 -
sridExpr
:一个可选的INTEGER
值,此值被设置为返回的GEOMETRY
值的 SRID。
退货
GEOMETRY(srid)
类型的值,其中,如果 srid
是常量(可折叠)表达式,则 sridExpr
是 sridExpr
的值,否则为 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)