ALTER FOREIGN DATA WRAPPER

ALTER FOREIGN DATA WRAPPER
Anterior	Acima	Comandos SQL	Principal	Próxima

ALTER FOREIGN DATA WRAPPER — modifica a definição de um empacotador de dados estrangeiros

Sinopse

ALTER FOREIGN DATA WRAPPER nome
    [ HANDLER função_tratadora | NO HANDLER ]
    [ VALIDATOR função_validadora | NO VALIDATOR ]
    [ OPTIONS ( [ ADD | SET | DROP ] opção ['valor'] [, ... ]) ]
ALTER FOREIGN DATA WRAPPER nome
    OWNER TO {
        novo_dono
      | CURRENT_ROLE
      | CURRENT_USER
      | SESSION_USER
    }
ALTER FOREIGN DATA WRAPPER nome
    RENAME TO novo_nome

Descrição

O comando ALTER FOREIGN DATA WRAPPER modifica a definição de um empacotador de dados estrangeiros. A primeira forma do comando altera as funções de suporte, ou as opções genéricas do empacotador de dados estrangeiros (é necessária pelo menos uma cláusula). A segunda forma altera o dono do empacotador de dados estrangeiros.

Somente os superusuários podem alterar empacotadores de dados estrangeiros. Além disso, apenas os superusuários podem ser donos de empacotadores de dados estrangeiros.

Parâmetros

nome

O nome do empacotador de dados estrangeiros existente.

HANDLER função_tratadora

Especifica a nova função tratadora para o empacotador de dados estrangeiros.

NO HANDLER

É usado para especificar que o empacotador de dados estrangeiros não deverá mais ter uma função tratadora.

Note que as tabelas estrangeiras que usam um empacotador de dados estrangeiros sem tratador não podem ser acessadas.

VALIDATOR função_validadora

Especifica a nova função validadora para o empacotador de dados estrangeiros.

Note ser possível que as opções pré-existentes do empacotador de dados estrangeiros, ou de servidores dependentes, mapeamentos de usuários, ou tabelas estrangeiras, sejam inválidas segundo o novo validador. O PostgreSQL não verifica isto. Cabe ao usuário certificar-se de que estas opções estejam corretas antes de usar o empacotador de dados estrangeiros modificado. Entretanto, quaisquer opções especificadas neste comando ALTER FOREIGN DATA WRAPPER serão verificadas usando o novo validador.

NO VALIDATOR

É usado para especificar que o empacotador de dados estrangeiros não deverá mais ter uma função validadora.

OPTIONS ( [ ADD | SET | DROP ] opção ['valor'] [, ... ] )

Altera as opções para o empacotador de dados estrangeiros. 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 empacotador de dados estrangeiros.

novo_nome

O novo nome para o empacotador de dados estrangeiros.

Exemplos

Alterar o empacotador de dados estrangeiros dbi, adicionar a opção foo, remover a opção bar:

ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP bar);

Alterar o validador do empacotador de dados estrangeiros dbi para bob.myvalidator:

ALTER FOREIGN DATA WRAPPER dbi VALIDATOR bob.myvalidator;

Conformidade

O comando ALTER FOREIGN DATA WRAPPER está em conformidade com o padrão ISO/IEC 9075-9 (SQL/MED), com a exceção de que as cláusulas HANDLER, VALIDATOR, OWNER TO e RENAME são extensões.

Veja também

CREATE FOREIGN DATA WRAPPER, DROP FOREIGN DATA WRAPPER