支援的版本: 目前 (17) / 16 / 15 / 14 / 13
開發版本: devel
不支援的版本: 12 / 11 / 10 / 9.6 / 9.5

IMPORT FOREIGN SCHEMA

IMPORT FOREIGN SCHEMA — 從外部伺服器匯入表格定義

概要

IMPORT FOREIGN SCHEMA remote_schema
    [ { LIMIT TO | EXCEPT } ( table_name [, ...] ) ]
    FROM SERVER server_name
    INTO local_schema
    [ OPTIONS ( option 'value' [, ... ] ) ]

說明

IMPORT FOREIGN SCHEMA 會建立代表外部伺服器上現有表格的外部表格。新的外部表格將由發出指令的使用者擁有,並使用正確的欄位定義和選項建立,以符合遠端表格。

預設情況下,會匯入外部伺服器上特定結構描述中存在的所有表格和檢視。您可以選擇性地將表格清單限制為指定的子集合,或排除特定表格。新的外部表格都會在目標結構描述中建立,而目標結構描述必須已存在。

若要使用 IMPORT FOREIGN SCHEMA,使用者必須擁有外部伺服器的 USAGE 權限,以及目標結構描述的 CREATE 權限。

參數

remote_schema

要從中匯入的遠端結構描述。遠端結構描述的具體含義取決於所使用的外部資料包裝函式。

LIMIT TO ( table_name [, ...] )

僅匯入符合給定表格名稱之一的外部表格。外部結構描述中存在的其他表格將被忽略。

EXCEPT ( table_name [, ...] )

從匯入中排除指定的外部表格。除了此處列出的表格外,將匯入外部結構描述中存在的所有表格。

server_name

要從中匯入的外部伺服器。

local_schema

將在其中建立匯入的外部表格的結構描述。

OPTIONS ( option 'value' [, ...] )

匯入期間要使用的選項。允許的選項名稱和值特定於每個外部資料包裝函式。

範例

從伺服器 film_server 上的遠端結構描述 foreign_films 匯入表格定義,並在本地結構描述 films 中建立外部表格

IMPORT FOREIGN SCHEMA foreign_films
    FROM SERVER film_server INTO films;

與上述相同,但僅匯入兩個表格 actorsdirectors (如果它們存在)

IMPORT FOREIGN SCHEMA foreign_films LIMIT TO (actors, directors)
    FROM SERVER film_server INTO films;

相容性

IMPORT FOREIGN SCHEMA 指令符合SQL標準,但 OPTIONS 子句是 PostgreSQL 的擴充。

提交更正

如果您在文件中發現任何不正確、與特定功能的體驗不符或需要進一步澄清之處,請使用此表格來報告文件問題。