全部產品
Search
文件中心

PolarDB:ST_RegForeignTables

更新時間:Jul 06, 2024

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

文法

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://<ak_id>:<ak_secret>@<endpoint>/data');
    --------------
     Create server 'ganos_fdw_server' successfully
  • 指定server_name
    SELECT ST_RegForeignTables('OSS://<ak_id>:<ak_secret>@<endpoint>/data',
                               'my_server');
    
    -------------
     Create server 'my_server' successfully
  • 指定驅動開啟選項
    SELECT ST_RegForeignTables('OSS://<ak_id>:<ak_secret>@<endpoint>/data',
                               'myserver',
                               'ESRI Shapefile',
                               '',
                               'SHAPE_ENCODING=LATIN1');
    
    -------------
     Create server 'myserver' successfully
  • 指定需要註冊的表
    SELECT ST_RegForeignTables('OSS://<ak_id>:<ak_secret>@<endpoint>/data',
                               'myserver',
                               'ESRI Shapefile',
                               '',
                               'SHAPE_ENCODING=LATIN1',
                               ARRAY['point', 'roads']::cstring[]);
    
    -------------
     Create server 'myserver' successfully
  • 指定外表首碼
    SELECT ST_RegForeignTables('OSS://<ak_id>:<ak_secret>@<endpoint>/data',
                               'myserver',
                               'ESRI Shapefile',
                               '',
                               'SHAPE_ENCODING=LATIN1',
                               ARRAY['point', 'roads']::cstring[],
                               'myprefix');
    
    -------------
     Create server 'myserver' successfully