Postgresql 中文操作指南

IMPORT FOREIGN SCHEMA

IMPORT FOREIGN SCHEMA——从外来服务器中导入表格信息

Synopsis

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

Description

IMPORT FOREIGN SCHEMA 会创建外来表格,这些表格代表外来服务器中的现有表格。所有者将是负责发布此命令的用户,创建时拥有与远程表格相匹配的正确列定义和选项。

默认情况下,将从外来服务器中的特定架构处导入所有现有表格和视图。或者,可以将表格列表限制为特定子集,或排除特定表格。所有新外来表格都将在目标架构中创建,目标架构必须已存在。

为了使用 IMPORT FOREIGN SCHEMA ,该用户必须拥有外来服务器上的 USAGE 权限,以及目标架构上的 CREATE 权限。

Parameters

  • remote_schema

    • 准备进行导入的远程架构。远程架构的具体含义取决于所用的外来数据封装器。

  • LIMIT TO ( _table_name [, …​] )_

    • 只导入与已给表名相匹配的外来表格。将忽略外来架构中存在的其他表格。

  • EXCEPT ( _table_name [, …​] )_

    • 排除指定外来表格,不进行导入。将导入外来架构中除列出表格外所有已存在的表格。

  • server_name

    • 准备进行导入的外来服务器。

  • local_schema

    • 准备创建已导入外来表格的架构。

  • OPTIONS ( _option ' value ' [, …​] )_

    • 导入期间使用的选项。允许的选项名和值取决于每个外来数据封装器。

Examples

从服务器 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;

Compatibility

IMPORT FOREIGN SCHEMA 命令符合 SQL 标准, OPTIONS 条款为 PostgreSQL 扩展。