FDW參考的函數ST_RegForeignTables - ApsaraDB RDS

將資料來源中的表註冊為外表。

文法

cstring ST_RegForeignTables(cstring source,
                            cstring server_name default '',
                            cstring driver default '',
                            cstring config_option default '',
                            cstring open_option default '',
                            cstring[] tables default NULL,
                            cstring prefix default '' );

參數

參數名稱	描述
source	資料來源，參見Object Storage Service服務路徑。
driver	使用的資料來源驅動程式，可以通過ST_FDWDrivers函數獲得。如果傳入Null 字元串，則表示使用預設的驅動嘗試訪問。
server_name	自動建立的Foreign Server的名稱，預設使用`ganos_fdw_server`。
config_option	環境變數參數選項。
open_option	資料來源開啟選項。
tables	需要註冊為外表的表名稱，可以通過ST_ForeignTables獲得。
prefix	註冊的外表首碼。

描述

將資料來源中的表註冊為外表。可以指定伺服器名稱、資料來源開啟資訊，可以通過information_schema.foreign_tables視圖擷取相關資訊。

樣本

只指定路徑

SELECT ST_RegForeignTables('OSS://<access_id>:<secrect_key>@[<Endpoint>]/<bucket>/path_to/file');
--------------
 Create server 'ganos_fdw_server' successfully

指定server_name

SELECT ST_RegForeignTables('OSS://<access_id>:<secrect_key>@[<Endpoint>]/<bucket>/path_to/file',
                           'my_server');

-------------
 Create server 'my_server' successfully

指定驅動開啟選項

SELECT ST_RegForeignTables('OSS://<access_id>:<secrect_key>@[<Endpoint>]/<bucket>/path_to/file',
                           'myserver',
                           'ESRI Shapefile',
                           '',
                           'SHAPE_ENCODING=LATIN1');

-------------
 Create server 'myserver' successfully

指定需要註冊的表

SELECT ST_RegForeignTables('OSS://<access_id>:<secrect_key>@[<Endpoint>]/<bucket>/path_to/file',
                           'myserver',
                           'ESRI Shapefile',
                           '',
                           'SHAPE_ENCODING=LATIN1',
                           ARRAY['point', 'roads']::cstring[]);

-------------
 Create server 'myserver' successfully

指定外表首碼

SELECT ST_RegForeignTables('OSS://<access_id>:<secrect_key>@[<Endpoint>]/<bucket>/path_to/file',
                           'myserver',
                           'ESRI Shapefile',
                           '',
                           'SHAPE_ENCODING=LATIN1',
                           ARRAY['point', 'roads']::cstring[],
                           'myprefix');

-------------
 Create server 'myserver' successfully