USERIDALIAS

Válido Para

Extract, Replicat, DEFGEN, Admin Client.

Suportado por

Todos os bancos de dados suportados para a versão.

Descrição

Use o parâmetro USERIDALIAS para especificar a autenticação de um processo do Oracle GoldenGate a ser usado ao fazer log-in em um banco de dados. O uso de USERIDALIAS requer o uso de um armazenamento de credenciais do Oracle GoldenGate. Especifique USERIDALIAS antes de qualquer entrada TABLE ou MAP no arquivo de parâmetros. Os privilégios necessários para o usuário USERIDALIAS variam de acordo com o banco de dados.

As seguintes regras se aplicam ao valor de <alias>:

• Pode ter até 30 caracteres de comprimento

• Deve começar com letra

• Pode incluir qualquer combinação de letras, números e os seguintes caracteres especiais:

  • Sinal de $ (dólar)

  • _ (sublinhado)

  • (hash) sinal

USERIDALIAS Comparado ao USERID

USERIDALIAS permite especificar um alias, em vez de um usuário ID e uma senha, no arquivo de parâmetros. Os IDs de usuário e as senhas criptografadas são armazenados em um armazenamento de credenciais. O USERIDALIAS suporta bancos de dados em execução nas plataformas Linux, UNIX e Windows.

USERID requer especificar a senha de texto sem formatação no arquivo de parâmetros ou criptografá-la com o comando ENCRYPT PASSWORD e, opcionalmente, armazenar uma chave de criptografia em um arquivo ENCKEYS. O USERID suporta uma ampla variedade de bancos de dados suportados pelo Oracle GoldenGate. Além disso, ele suporta o uso de um log-in no sistema operacional para o Oracle AI Database.

Requisitos de USERIDALIAS por Tipo de Banco de Dados

O uso de USERIDALIAS varia dependendo do tipo de banco de dados. Observação: o log-in que requer um usuário e uma senha do banco de dados deve ser armazenado no armazenamento de credenciais do Oracle GoldenGate.

Os USERID especificados suportados em USERIDALIAS no Oracle GoldenGate com MySQL MA são:

• user/db

• user@host/db

• user@host:port/db

Se um usuário do Oracle GoldenGate tiver permissão para alterar ou adicionar um USERIDALIAS que não siga nenhum dos padrões anteriores, o usuário verá o erro na correspondência de padrões no cliente, como o cliente da interface Web MA ou o Cliente Admin.

DB2 para LUW

Use o parâmetro USERIDALIAS para todos os processos do Oracle GoldenGate que se conectam a um banco de dados LUW Db2 usando a autenticação do banco de dados.

MySQL

Use USERIDALIAS para todos os processos do Oracle GoldenGate que se conectam a um banco de dados MySQL.

Oracle

Use USERIDALIAS para processos do Oracle GoldenGate que se conectam a um Oracle AI Database.

• Especifique o alias de uma credencial de banco de dado armazenada no armazenamento da credencial do Oracle GoldenGate.

• Privilégios especiais de banco de dados são necessários para o usuário USERIDALIAS quando o Extract está configurado para usar LOGRETENTION. Esses privilégios podem ter sido concedidos quando o Oracle GoldenGate foi instalado. Consulte Configurar Propriedades de Log para obter mais informações sobre o LOGRETENTION.

• Para usar o USERIDALIAS para um grupo Extract configurado para captura integrada, o usuário deve ter privilégios. Se estiver usando o Oracle AI Database 26ai e versões posteriores, os privilégios de usuário poderão ser concedidos com as atribuições de usuário OGG_CAPTURE e OGG_APPLY. Se estiver usando o banco de dados Oracle 21c ou inferior, o usuário deverá ter privilégios no procedimento dbms_goldengate_auth.grant_admin_privilege. O usuário deve ser o mesmo que emite DBLOGIN e REGISTER EXTRACT ou UNREGISTER EXTRACT para o grupo de Extract associado a este USERIDALIAS.

  Para obter detalhes sobre como conceder privilégios de usuário do Oracle AI Database 26ai, consulte Conceder Privilégios de Usuário para o Oracle AI Database 26ai e versões mais recentes.

  Para obter detalhes sobre como conceder privilégios para o Oracle Database 21c e inferior, consulte Conceder Privilégios de Usuário para o Oracle Database 21c e inferior.

USERIDALIAS com Autenticação Kerberos

Suportado somente para o Oracle AI Database.

Defina o ALTER CREDENTIALSTORE para usar a palavra-chave NOPASSWORD, pois a autenticação é externa. Consulte ALTER CREDENTIALSTORE para saber mais.

SQL Server

Use USERIDALIAS se a conexão da origem de dados ODBC que será usada pelo processo do Oracle GoldenGate estiver configurada para estabelecer conexão usando a autenticação do SQL Server.

Teradados

Use USERIDALIAS para processos do Oracle GoldenGate que se conectam a um banco de dados Teradata.

Padrão

Nenhum

Sintaxe

USERIDALIAS <alias> [DOMAIN <domain>] [SYSDBA]
[, THREADS (<threadID>[, <threadID>][, ...][, <thread_range>[, <thread_range>][, ...])]

<alias>

Especifica o alias de uma credencial de usuário do banco de dados que se encontra no armazenamento de credenciais do Oracle GoldenGate.

DOMAIN <domain>

Especifica o domínio do armazenamento de credenciais para o alias especificado. Uma entrada válida do domínio deve existir no armazenamento de credenciais para o alias especificado.

SYSDBA

(Oracle) Especifica que o usuário efetua log-in como sysdba.

THREADS (<threadID>[, <threadID>][, ...][, <thread_range>[, <thread_range>][, ...])

Válido para Replicat. Vincula a credencial especificada a um ou mais threads de uma Reposição coordenada. Permite especificar log-ins diferentes para threads diferentes.

<threadID>[, <threadID>][, ...]

Especifica um thread ID ou uma lista de threads delimitada por vírgulas no formato threadID, threadID, threadID.

[, <thread_range>[, <thread_range>][, ...]

Especifica uma faixa de threads na forma de threadIDlow-threadIDhigh ou de uma lista de faixas delimitada por vírgulas no formato de threadIDlow-threadIDhigh, threadIDlow-threadIDhigh.

Uma combinação desses formatos é permitida, como threadID, threadID, threadIDlow-threadIDhigh.

TimesTen

Use USERIDALIAS para processos do Oracle GoldenGate que se conectam a um banco de dados TimesTen.

Padrão

Nenhum

Sintaxe

USERIDALIAS <alias> [DOMAIN <domain>] [SYSDBA]
[, THREADS (<threadID>[, <threadID>][, ...][, <thread_range>[, <thread_range>][, ...])]

<alias>

Especifica o alias de uma credencial de usuário do banco de dados que se encontra no armazenamento de credenciais do Oracle GoldenGate.

DOMAIN <domain>

Especifica o domínio do armazenamento de credenciais para o alias especificado. Uma entrada válida do domínio deve existir no armazenamento de credenciais para o alias especificado.

SYSDBA

(Oracle) Especifica que o usuário efetua log-in como sysdba.

THREADS (<threadID>[, <threadID>][, ...][, <thread_range>[, <thread_range>][, ...])

Válido para Replicat. Vincula a credencial especificada a um ou mais threads de uma Reposição coordenada. Permite especificar log-ins diferentes para threads diferentes.

<threadID>[, <threadID>][, ...]

Especifica um thread ID ou uma lista de threads delimitada por vírgulas no formato threadID, threadID, threadID.

[, <thread_range>[, <thread_range>][, ...]

Especifica uma faixa de threads na forma de threadIDlow-threadIDhigh ou de uma lista de faixas delimitada por vírgulas no formato de threadIDlow-threadIDhigh, threadIDlow-threadIDhigh.

Uma combinação desses formatos é permitida, como threadID, threadID, threadIDlow-threadIDhigh.

Exemplos

Exemplo 1

O seguinte fornece uma credencial para o usuário no armazenamento de credenciais que tem o alias tiger1 no domínio de east.

USERIDALIAS tiger1 DOMAIN east

Exemplo 2

O seguinte fornece uma credencial para o thread 3 de um Replicat coordenado.

USERIDALIAS tiger1 DOMAIN east THREADS (3)

Exemplo 3

O exemplo a seguir mostra o uso do parâmetro em PostgreSQL:

USERIDALIAS pgdsn

O exemplo a seguir mostra como usar a autenticação do Kerberos com o Oracle GoldenGate Admin Client:

OGG (http://localhost:9005 demo)4> dblogin useridalias ggma
Successfully logged into database CDB1_PDB1

Neste exemplo, o armazenamento de credenciais é configurado anteriormente usando o comando ALTER CREDENTIALSTORE.