2025年9月25日: PostgreSQL 18 釋出!
支援的版本: 當前 (18) / 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 的擴充套件。

提交更正

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