类别：

地理空间函数、转换函数

ST_GEOGRAPHYFROMWKB

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

别名：

ST_GEOGFROMWKB、ST_GEOGRAPHYFROMEWKB、ST_GEOGFROMEWKB

另请参阅：

TO_GEOGRAPHY

语法

ST_GEOGRAPHYFROMWKB( <varchar_or_binary_expression> [ , <allow_invalid> ] )

ST_GEOGFROMWKB( <varchar_or_binary_expression> [ , <allow_invalid> ] )

ST_GEOGRAPHYFROMEWKB( <varchar_or_binary_expression> [ , <allow_invalid> ] )

ST_GEOGFROMEWKB( <varchar_or_binary_expression> [ , <allow_invalid> ] )

实参

必填：

varchar_or_binary_expression

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

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

可选：

allow_invalid

If TRUE, specifies that the function returns a GEOGRAPHY or GEOMETRY object, even when the input shape isn't valid and can't be repaired. For more information, see 指定如何处理无效的地理空间形状.

返回

该函数返回 GEOGRAPHY 类型的值。

使用说明

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

  • 如果输入格式为 EWKB 且 SRID 不是 4326，则会引发错误。请参阅 EWKT 和 EWKB 处理备注。

示例

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

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';

select ST_GEOGRAPHYFROMWKB('01010000006666666666965EC06666666666C64240');
+-------------------------------------------------------------------+
| ST_GEOGRAPHYFROMWKB('01010000006666666666965EC06666666666C64240') |
|-------------------------------------------------------------------|
| POINT(-122.35 37.55)                                              |
+-------------------------------------------------------------------+

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

-- Set the output format to EWKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='EWKT';

select ST_GEOGRAPHYFROMEWKB('0101000020E61000006666666666965EC06666666666C64240');
+----------------------------------------------------------------------------+
| ST_GEOGRAPHYFROMEWKB('0101000020E61000006666666666965EC06666666666C64240') |
|----------------------------------------------------------------------------|
| SRID=4326;POINT(-122.35 37.55)                                             |
+----------------------------------------------------------------------------+