PostgreSQL: 文档: 17: IMPORT FOREIGN SCHEMA

支持的版本: 当前 (17) / 16 / 15 / 14 / 13

开发版本: 开发版

不支持的版本: 12 / 11 / 10 / 9.6 / 9.5

IMPORT FOREIGN SCHEMA
上一个	向上	SQL 命令	首页	下一个

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;

如上所述，但仅导入两个表 actors 和 directors（如果它们存在）

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

兼容性

IMPORT FOREIGN SCHEMA 命令符合SQL标准，除了 OPTIONS 子句是 PostgreSQL 扩展。

另请参阅

CREATE FOREIGN TABLE, CREATE SERVER

上一个	向上	下一个
GRANT	首页	INSERT

提交更正

如果您在文档中看到任何不正确、与您使用特定功能的体验不符或需要进一步澄清的内容，请使用此表单报告文档问题。