通过

st_geomfromwkb 函数

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

Important

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

注释

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

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

Syntax

st_geomfromwkb ( wkbExpr[, sridExpr] )

Arguments

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

Returns

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

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

错误条件

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

Examples

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