全部產品
Search
文件中心

PolarDB:ST_ValidateOSGB

更新時間:Jul 06, 2024

對基於Object Storage Service的傾斜攝影專案(OSGB 格式)進行格式驗證。

文法

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

傳回值

欄位

描述

valid

是否為有效OSGB。

reason

失敗原因,如果為有效OSGB,則為NULL。

參數

參數名稱

描述

url

基於Object Storage Service服務的路徑。

options

json字串描述選項。詳情請參見選項說明

描述

對基於Object Storage Service的傾斜攝影專案(OSGB格式)進行格式驗證。會檢查OSGB資料檔案的丟失與錯誤情況,並進行報告。本函數適用於對資料完整性有嚴格要求的情境或排查匯入時發生致命錯誤的異常檔案。

資料約定可參考匯入函數ST_ImportOSGB

選項說明:

參數名稱

類型

說明

預設值

樣本

parallel

整數

並行度。提高並行度將會加速匯入,但可能消耗大量記憶體,可根據實際的資料或資料庫運行狀態選擇合適的值。

一般小於16為宜。小於1將被忽略。

1

16

exclude

字串

根據檔案路徑排除OSGB的Regex。

-

Tile_A(將排除檔案路徑中包含Tile_A的OSGB檔案)。

include

字串

根據檔案路徑包含OSGB的Regex。

-

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 +