ALTER SERVER

ALTER SERVER
Anterior	Acima	Comandos SQL	Principal	Próxima

ALTER SERVER — modifica a definição de um servidor estrangeiro

Sinopse

ALTER SERVER nome [ VERSION 'nova_versão' ]
    [ OPTIONS ( [ ADD | SET | DROP ] opção ['valor'] [, ... ] ) ]
ALTER SERVER nome
    OWNER TO {
        novo_dono
      | CURRENT_ROLE
      | CURRENT_USER
      | SESSION_USER
    }
ALTER SERVER nome
    RENAME TO novo_nome

Descrição

O comando ALTER SERVER altera a definição de um servidor estrangeiro existente. A primeira forma altera a cadeia de caracteres da versão do servidor, ou as opções genéricas do servidor (é necessário pelo menos uma cláusula). A segunda forma altera o dono do servidor.

Para alterar o servidor, é necessário ser o dono do servidor. Além disso, para alterar o dono, é necessário ter a permissão SET ROLE para a função de banco de dados (role) que será a nova dona, e é necessário ter privilégio USAGE no empacotador de dados estrangeiros do servidor. (Observe que os superusuários satisfazem a todos estes critérios automaticamente.)

Parâmetros

nome: O nome do servidor existente.
nova_versão: Nova versão do servidor.
OPTIONS ( [ ADD | SET | DROP ] opção ['valor'] [, ... ] ): Altera as opções do servidor. ADD, SET, e DROP, especificam a ação a ser executada. É assumido ADD, se nenhuma ação for especificada explicitamente. Os nomes das opções devem ser únicos; os nomes e valores também são validados usando a função validadora do empacotador de dados estrangeiros, se houver.
novo_dono: O nome de usuário do novo dono do servidor estrangeiro.
novo_nome: O novo nome para o servidor estrangeiro.

Exemplos

Alterar o servidor foo, adicionando opções de conexão:

ALTER SERVER foo OPTIONS (host 'foo', dbname 'foodb');

Alterar o servidor foo, mudar a versão, e mudar a opção host:

ALTER SERVER foo VERSION '8.4' OPTIONS (SET host 'baz');

Conformidade

O comando ALTER SERVER está em conformidade com o padrão ISO/IEC 9075-9 (SQL/MED). As formas OWNER TO e RENAME TO são extensões do PostgreSQL.

Veja também

CREATE SERVER, DROP SERVER