CREATE SERVER

CREATE SERVER
Prev	Up	Comandos SQL	Home	Next

CREATE SERVER — define un nuevo servidor foráneo

Synopsis

CREATE SERVER [ IF NOT EXISTS ] nombre_servidor [ TYPE 'tipo_servidor' ] [ VERSION 'versión_servidor' ]
    FOREIGN DATA WRAPPER nombre_fdw
    [ OPTIONS ( opción 'valor' [, ... ] ) ]

Descripción

CREATE SERVER define un nuevo servidor foráneo. El usuario que define el servidor se convierte en su propietario.

Un servidor foráneo típicamente encapsula la información de conexión que un envolvedor de datos foráneos (foreign-data wrapper) utiliza para acceder a un recurso de datos externo. Se puede especificar información de conexión adicional específica del usuario mediante mapeos de usuario.

El nombre del servidor debe ser único dentro de la base de datos.

La creación de un servidor requiere el privilegio USAGE en el envolvedor de datos foráneos que se va a utilizar.

Parámetros

IF NOT EXISTS: No lanza un error si ya existe un servidor con el mismo nombre. En este caso se emite un aviso. Ten en cuenta que no hay garantía de que el servidor existente sea similar al que se habría creado.
nombre_servidor: El nombre del servidor foráneo a crear.
tipo_servidor: Tipo de servidor opcional, potencialmente útil para los envolvedores de datos foráneos.
versión_servidor: Versión de servidor opcional, potencialmente útil para los envolvedores de datos foráneos.
nombre_fdw: El nombre del envolvedor de datos foráneos que gestiona el servidor.
OPTIONS ( opción 'valor' [, ... ] ): Esta cláusula especifica las opciones para el servidor. Típicamente, las opciones definen los detalles de conexión del servidor, pero los nombres y valores reales dependen del envolvedor de datos foráneos del servidor.

Notas

Al utilizar el módulo dblink, el nombre de un servidor foráneo se puede usar como argumento de la función dblink_connect para indicar los parámetros de conexión. Es necesario tener el privilegio USAGE en el servidor foráneo para poder usarlo de esta manera.

Si el servidor foráneo admite la delegación de ordenamiento (sort pushdown), es necesario que tenga el mismo orden de clasificación (colación) que el servidor local.

Ejemplos

Crea un servidor myserver que utiliza el envolvedor de datos foráneos postgres_fdw:

CREATE SERVER myserver FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'foo', dbname 'foodb', port '5432');

Consulta la postgres_fdw para obtener más detalles.

Compatibilidad

CREATE SERVER cumple con el estándar ISO/IEC 9075-9 (SQL/MED).

Consulte también

ALTER SERVER, DROP SERVER, CREATE FOREIGN DATA WRAPPER, CREATE FOREIGN TABLE, CREATE USER MAPPING