ST_GeographyFromWKB
将熟知二进制 (WKB) 值转换为其对应的 GEOGRAPHY 对象。使用此函数可将 WKB 转换为 Vertica Place 函数所需的格式。
GEOGRAPHY 对象是在地球表面定义的空间对象。坐标使用划分地球的参考平面的度数(经度、纬度)表示。所有的计算都以米为单位。
GEOGRAPHY 对象的最大大小为 10 MB。如果将 WKB 传递给 ST_GeographyFromWKB 并且生成大小超过 10 MB 的空间对象,ST_GeographyFromWKB 将会返回错误。
开放地理空间联盟 (OGC) 在 OGC 简易功能访问第 1 部分 - 通用架构规范的第 8 节定义了 WKB 表示的格式。
行为类型
不可变语法
ST_GeographyFromWKB( wkb [ USING PARAMETERS ignore_errors={'y'|'n'} ] )
参数
wkb
- GEOGRAPHY 对象的熟知二进制 (WKB) 值,类型为 LONG VARBINARY
ignore_errors
- (可选)ST_GeographyFromWKB 基于提供的参数返回以下结果:
-
NULL—如果
wkb
无效并且ignore_errors
='y'
。 -
Error—如果
wkb
无效并且ignore_errors
='n'
或未指定。
-
返回
GEOGRAPHY
支持的数据类型
示例
以下示例显示了 ST_GeographyFromWKB 的用法。
将 WKB 转换为 GEOGRAPHY 对象:
=> CREATE TABLE wkb_ex (g GEOGRAPHY);
CREATE TABLE
=> INSERT INTO wkb_ex VALUES(ST_GeographyFromWKB(X'0103000000010000000 ... );
OUTPUT
--------
1
(1 row)