st_asbinary 函数

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

Important

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

返回GEOGRAPHYGEOMETRY值的WKB格式,使用指定的字节序(如果提供)。 如果未指定字节序,则返回的值是小端编码值。

Syntax

st_asbinary ( geoExpr[, endiannessExpr] )

Arguments

  • geoExprGEOGRAPHYGEOMETRY值。
  • endiannessExpr:一个可选的 STRING 值,表示输出 WKB 的字节序,默认是 'NDR' 表示小端序或 'XDR' 表示大端序。

Returns

一个 BINARY 类型的值。 返回的值是使用指定的字节序(如果提供)的输入 GEOGRAPHYGEOMETRY 值的 WKB 描述。 如果未指定字节序,则返回的值是小端编码值。

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

Examples

-- Export a 3DZ Cartesian point in WKB format (default endianness).
> SELECT hex(st_asbinary(st_geomfromtext('POINT Z (1 2 100)')))
  01E9030000000000000000F03F00000000000000400000000000005940

-- Export a 3DZ geographic point in big -endianness WKB format.
> SELECT hex(st_asbinary(st_geogfromtext('POINT Z (1 2 100)'), 'XDR'))
  00000003E93FF000000000000040000000000000004059000000000000