CREATE SERVER

CREATE SERVER
Anterior	Acima	Comandos SQL	Principal	Próxima

CREATE SERVER — define um novo servidor estrangeiro

Sinopse

CREATE SERVER [ IF NOT EXISTS ] nome_do_servidor
    [ TYPE 'tipo_do_servidor' ]
    [ VERSION 'versão_do_servidor' ]
    FOREIGN DATA WRAPPER nome_do_empacotador_dados_estrangeiros
    [ OPTIONS ( opção 'valor' [, ... ] ) ]

Descrição

O comando CREATE SERVER define um novo servidor estrangeiro. O usuário que define o servidor se torna o seu dono.

O servidor estrangeiro geralmente encapsula as informações de conexão que o empacotador de dados estrangeiros usa para acessar um recurso de dados externo. Informações adicionais de conexão específicas do usuário podem ser especificadas por meio de mapeamentos de usuários.

O nome do servidor deve ser único no banco de dados.

A criação do servidor requer o privilégio USAGE no empacotador de dados estrangeiros que está sendo usado.

Parâmetros

IF NOT EXISTS: Não relata um erro se já existir um servidor com o mesmo nome. É emitido um aviso neste caso. Note que não há garantia de que o servidor existente seja semelhante com aquele que teria sido criado.
nome_do_servidor: O nome do servidor estrangeiro a ser criado.
tipo_do_servidor: O tipo do servidor (opcional), potencialmente útil para empacotadores de dados estrangeiros.
versão_do_servidor: Versão de servidor (opcional), potencialmente útil para empacotadores de dados estrangeiros.
nome_do_empacotador_dados_estrangeiros: O nome do empacotador de dados estrangeiros que gerencia o servidor.
OPTIONS ( opção 'valor' [, ... ] ): Esta cláusula especifica as opções para o servidor. As opções geralmente definem os detalhes da conexão do servidor, mas os nomes e valores reais dependem do empacotador de dados estrangeiros do servidor.

Notas

Ao usar o módulo dblink, o nome do servidor externo pode ser usado como argumento da função dblink_connect, para indicar os parâmetros de conexão. É necessário ter o privilégio USAGE no servidor estrangeiro para poder utilizá-lo desta forma.

Se o servidor estrangeiro tiver suporte para o recurso de enviar a ordenação (pushdown), é necessário que ele tenha a mesma ordem de classificação que o servidor local.

Exemplos

Criar o servidor meu_servidor que usa o empacotador de dados estrangeiros postgres_fdw:

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

Veja postgres_fdw para obter mais detalhes.

Conformidade

O comando CREATE SERVER está em conformidade com o padrão ISO/IEC 9075-9 (SQL/MED).

Veja também

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