IMPORT FOREIGN SCHEMA

IMPORT FOREIGN SCHEMA
Anterior	Acima	Comandos SQL	Principal	Próxima

IMPORT FOREIGN SCHEMA — importa definições de tabela de um servidor estrangeiro

Sinopse

IMPORT FOREIGN SCHEMA esquema_remoto
    [ { LIMIT TO | EXCEPT } ( nome_da_tabela [, ...] ) ]
    FROM SERVER nome_do_servidor
    INTO esquema_local
    [ OPTIONS ( opção 'valor' [, ... ] ) ]

Descrição

O comando IMPORT FOREIGN SCHEMA cria tabelas estrangeiras que representam as tabelas existentes em um servidor estrangeiro. O usuário que executa o comando se torna o dono das tabelas estrangeiras, criadas com as definições e opções de coluna corretas para corresponder às tabelas remotas.

Por padrão, todas as tabelas e visões existentes em um determinado esquema no servidor estrangeiro são importadas. Opcionalmente, a lista de tabelas pode ser limitada a um subconjunto especificado, ou podem ser deixadas de fora determinadas tabelas. As novas tabelas estrangeiras são todas criadas no esquema de destino, que já deverá existir.

Para usar o comando IMPORT FOREIGN SCHEMA, é necessário ter o privilégio USAGE ON FOREIGN SERVER no servidor estrangeiro, bem como o privilégio CREATE no esquema de destino.

Parâmetros

esquema_remoto: O esquema remoto do qual importar. O significado específico do esquema remoto depende do empacotador de dados estrangeiros em uso.
LIMIT TO ( nome_da_tabela [, ...] ): Importa apenas as tabelas estrangeiras correspondentes a um dos nomes de tabela fornecidos. As outras tabelas existentes no esquema estrangeiro serão ignoradas.
EXCEPT ( nome_da_tabela [, ...] ): Exclui as tabelas estrangeiras especificadas da importação. Todas as tabelas existentes no esquema estrangeiro serão importadas, exceto as listadas aqui.
nome_do_servidor: O servidor estrangeiro do qual importar.
esquema_local: O esquema onde as tabelas estrangeiras importadas serão criadas.
OPTIONS ( opção 'valor' [, ...] ): Opções a serem usadas durante a importação. Os nomes e valores de opção permitidos são específicos para cada empacotador de dados estrangeiros.

Exemplos

Importar as definições de tabela do esquema remoto foreign_films no servidor film_server, criando as tabelas estrangeiras no esquema local films:

IMPORT FOREIGN SCHEMA foreign_films
    FROM SERVER film_server INTO films;

Como acima, mas importando apenas as duas tabelas actors e directors (se existirem):

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

Conformidade

O comando IMPORT FOREIGN SCHEMA está em conformidade com o padrão SQL, exceto pela cláusula OPTIONS que é uma extensão do PostgreSQL.

Veja também

CREATE FOREIGN TABLE, CREATE SERVER