IMPORT FOREIGN SCHEMA

IMPORT FOREIGN SCHEMA
Prev	Up	Comandos SQL	Home	Next

IMPORT FOREIGN SCHEMA — importar definiciones de tablas de un servidor foráneo

Synopsis

IMPORT FOREIGN SCHEMA esquema_remoto
    [ { LIMIT TO | EXCEPT } ( nombre_tabla [, ...] ) ]
    FROM SERVER nombre_servidor
    INTO esquema_local
    [ OPTIONS ( opción 'valor' [, ... ] ) ]

Descripción

IMPORT FOREIGN SCHEMA crea tablas foráneas que representan tablas existentes en un servidor foráneo. Las nuevas tablas foráneas serán propiedad del usuario que ejecuta el comando y se crean con las definiciones de columna y opciones correctas para que coincidan con las tablas remotas.

Por omisión, se importan todas las tablas y vistas existentes en un esquema particular en el servidor foráneo. Opcionalmente, la lista de tablas se puede limitar a un subconjunto especificado, o se pueden excluir tablas específicas. Las nuevas tablas foráneas se crean todas en el esquema de destino, el cual ya debe existir.

Para usar IMPORT FOREIGN SCHEMA, el usuario debe tener el privilegio USAGE en el servidor foráneo, así como el privilegio CREATE en el esquema de destino.

Parámetros

esquema_remoto: El esquema remoto desde el cual importar. El significado específico de un esquema remoto depende del wrapper de datos foráneos (foreign data wrapper) en uso.
LIMIT TO ( nombre_tabla [, ...] ): Importa únicamente las tablas foráneas que coincidan con uno de los nombres de tabla indicados. Se ignorarán las demás tablas existentes en el esquema foráneo.
EXCEPT ( nombre_tabla [, ...] ): Excluye de la importación las tablas foráneas especificadas. Se importarán todas las tablas existentes en el esquema foráneo excepto las listadas aquí.
nombre_servidor: El servidor foráneo desde el cual importar.
esquema_local: El esquema en el cual se crearán las tablas foráneas importadas.
OPTIONS ( opción 'valor' [, ...] ): Opciones que se utilizarán durante la importación. Los nombres y valores de opciones permitidos son específicos de cada wrapper de datos foráneos.

Ejemplos

Importar definiciones de tablas de un esquema remoto foreign_films en el servidor film_server, creando las tablas foráneas en el esquema local films:

IMPORT FOREIGN SCHEMA foreign_films
    FROM SERVER film_server INTO films;

Como el anterior, pero importando solo las dos tablas actors y directors (si existen):

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

Compatibilidad

El comando IMPORT FOREIGN SCHEMA cumple con el estándar SQL, excepto que la cláusula OPTIONS es una extensión de PostgreSQL.

Véase también

CREATE FOREIGN TABLE, CREATE SERVER