类别：

地理空间函数、转换函数

ST_GEOMETRYFROMWKB

解析 WKB（已知二进制） (link removed) 或 EWKB（扩展的已知二进制）输入，并返回 GEOMETRY 类型的值。

别名：

ST_GEOMFROMWKB、ST_GEOMETRYFROMEWKB、ST_GEOMFROMEWKB

另请参阅：

TO_GEOMETRY

语法

ST_GEOMETRYFROMWKB( <varchar_or_binary_expression> [ , <srid> ]  [ , <allow_invalid> ] )

ST_GEOMFROMWKB( <varchar_or_binary_expression> [ , <srid> ]  [ , <allow_invalid> ] )

ST_GEOMETRYFROMEWKB( <varchar_or_binary_expression> [ , <srid> ] [ , <allow_invalid> ] )

ST_GEOMFROMEWKB( <varchar_or_binary_expression> [ , <srid> ] [ , <allow_invalid> ] )
Copy

实参

必填：

varchar_or_binary_expression

实参必须是表示有效地理空间对象的字符串或二进制表达式（格式为 WKB 或 EWKB）。

字符串表达式必须采用十六进制格式（不带前导 0x）。

可选：

srid

要使用的 SRID 的整数值。

allow_invalid

如果为 TRUE，即使输入形状无效且无法修复，指定函数也应返回 GEOGRAPHY 或 GEOMETRY 对象。有关详细信息，请参阅 指定如何处理无效的地理空间形状。

返回

该函数返回 GEOMETRY 类型的值。

使用说明

  • 如果无法将输入解析为 WKB 或 EWKB，则会引发错误。

  • 对于 WKB 输入，如果未指定 srid 实参，则生成的 GEOMETRY 对象将 SRID 设置为 0。

示例

以下示例返回以 EWKB 格式描述的地理空间对象的 GEOMETRY 对象：

-- Set the geometry output format to EWKT
ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT ST_GEOMETRYFROMEWKB('0101000020797F000066666666A9CB17411F85EBC19E325641');
Copy
+---------------------------------------------------------------------------+
| ST_GEOMETRYFROMEWKB('0101000020797F000066666666A9CB17411F85EBC19E325641') |
|---------------------------------------------------------------------------|
| SRID=32633;POINT(389866.35 5819003.03)                                    |
+---------------------------------------------------------------------------+
Copy

在下一个示例中，输入采用 WKB 格式且未指定 SRID：

-- Set the geometry output format to EWKT
ALTER SESSION SET GEOMETRY_OUTPUT_FORMAT='EWKT';

SELECT ST_GEOMETRYFROMEWKB('010100000066666666A9CB17411F85EBC19E325641');
Copy
+-------------------------------------------------------------------+
| ST_GEOMETRYFROMEWKB('010100000066666666A9CB17411F85EBC19E325641') |
|-------------------------------------------------------------------|
| SRID=0;POINT(389866.35 5819003.03)                                |
+-------------------------------------------------------------------+
Copy
语言: 中文