CREATE USER MAPPING

CREATE USER MAPPING — define um novo mapeamento de usuário para servidor estrangeiro

Sinopse

CREATE USER MAPPING [ IF NOT EXISTS ] FOR
    { nome_do_usuário
      | USER
      | CURRENT_ROLE
      | CURRENT_USER
      | PUBLIC
    }
    SERVER nome_do_servidor
    [ OPTIONS ( opção 'valor' [ , ... ] ) ]

Descrição

O comando CREATE USER MAPPING define um novo mapeamento de usuário para servidor estrangeiro [146]. O mapeamento de usuário geralmente encapsula as informações de conexão que o empacotador de dados estrangeiros usa junto com as informações do servidor estrangeiro, para acessar um recurso de dados externo.

O dono do servidor estrangeiro pode criar mapeamentos de usuário para este servidor para qualquer usuário. Além disso, um usuário pode criar mapeamento de usuário para seu próprio nome de usuário, se tiver sido concedido o privilégio USAGE no servidor ao usuário.

Parâmetros

IF NOT EXISTS

Não relata um erro se já existir um mapeamento do usuário fornecido para o servidor estrangeiro especificado. É emitido um aviso neste caso. Note não haver garantia de que o mapeamento de usuário existente seja semelhante ao que teria sido criado.

nome_do_usuário

O nome do usuário existente a ser mapeado para o servidor estrangeiro. Os termos CURRENT_ROLE, CURRENT_USER, e USER, correspondem ao nome do usuário corrente. Quando é especificado PUBLIC, é criado o chamado mapeamento público, a ser usado quando nenhum mapeamento específico do usuário for aplicável.

nome_do_servidor

O nome do servidor existente para o qual o mapeamento de usuário deve ser criado.

OPTIONS ( opção 'valor' [, ... ] )

Esta cláusula especifica as opções de mapeamento do usuário. As opções geralmente definem o nome de usuário e a senha reais do mapeamento. Os nomes das opções devem ser únicos. Os nomes e valores de opção permitidos são específicos para o empacotador de dados estrangeiros do servidor.

Exemplos

Criar um mapeamento de usuário para o usuário bob, no servidor foo:

CREATE USER MAPPING
    FOR bob
    SERVER foo
    OPTIONS (user 'bob', password 'secret');

Conformidade

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

Consulta

As informações sobre mapeamentos de usuários podem ser consultadas através da visão do sistema pg_user_mappings.

Veja também

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


[146] O comando CREATE USER MAPPING define um mapeamento entre um ID de autorização que usa um banco de dados federado e o ID de autorização e senha a serem usados ​​em uma fonte de dados específica. IBM DB2 12.1.x – CREATE USER MAPPING statement (N. T.)