ST_ValidateOSGB

对基于对象存储的倾斜摄影项目(OSGB 格式)进行格式验证。

语法

record ST_ValidateOSGB(cstring url, cstring options default '{}', out valid boolean, out reason text);

返回值

字段

描述

valid

是否为有效的OSGB。

reason

失败原因,如果为有效的OSGB,则为NULL。

参数

参数名称

描述

url

基于对象存储服务的路径。

options

json字符串描述选项。详情请参见选项说明

描述

对基于对象存储的倾斜摄影项目(OSGB格式)进行格式验证。会检查OSGB数据文件的丢失与错误情况,并进行报告。本函数适用于对数据完整性有严格要求的场景或排查导入时发生致命错误的异常文件。

数据约定可参考导入函数ST_ImportOSGB

选项说明:

参数名称

类型

说明

默认值

示例

parallel

整数

并行度。提高并行度将会加速导入,但可能消耗大量内存,可根据实际的数据或数据库运行状态选择合适的值。

一般小于16为宜。小于1将被忽略。

1

16

exclude

字符串

根据文件路径排除OSGB的正则表达式。

-

Tile_A(将排除文件路径中包含Tile_A的OSGB文件)。

include

字符串

根据文件路径包含OSGB的正则表达式。

-

Tile_B(将仅入库文件路径中包含Tile_B的OSGB文件)。

示例

SELECT ST_ValidateOSGB('OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/path_to_oblique_project/');

---------
 f       | Missing or error file(s):                                     +
         |         /Data/Tile_+006_+004/Tile_+006_+004_L19_000000t3.osgb +
         |         /Data/Tile_+006_+004/Tile_+006_+004_L20_0000130t3.osgb+
         |         /Data/Tile_+006_+004/Tile_+006_+004_L21_00001110.osgb +

并行

SELECT ST_ValidateOSGB('OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/path_to_oblique_project/', '{"parallel": 4}');

---------
 f       | Missing or error file(s):                                     +
         |         /Data/Tile_+006_+004/Tile_+006_+004_L19_000000t3.osgb +
         |         /Data/Tile_+006_+004/Tile_+006_+004_L20_0000130t3.osgb+
         |         /Data/Tile_+006_+004/Tile_+006_+004_L21_00001110.osgb +