USERIDALIAS

Válido para

Extract, Replicat, DEFGEN, Admin Client.

Soportado para

Todas las bases de datos soportadas para la versión.

Descripción

Utilice el parámetro USERIDALIAS para especificar la autenticación de un proceso de Oracle GoldenGate que se utilizará al conectarse a una base de datos. El uso de USERIDALIAS necesita el uso de un almacén de credenciales de Oracle GoldenGate. Especifique USERIDALIAS antes de cualquier entrada TABLE o MAP en el archivo de parámetros. Los privilegios necesarios para el usuario USERIDALIAS varían según la base de datos.

Las siguientes reglas se aplican al valor de <alias>:

• Puede tener un máximo de 30 caracteres

• Debe empezar por un carácter alfabético

• Puede incluir cualquier combinación de letras, números y los siguientes caracteres especiales:

  • $ (dólar) signo

  • _ (carácter de subrayado)

  • signo (hash)

Comparación de USERIDALIAS con USERID

USERIDALIAS permite especificar un alias, en lugar de un usuario ID y una contraseña, en el archivo de parámetros. Los ID de usuario y las contraseñas cifradas se almacenan en un almacén de credenciales. USERIDALIAS soporta bases de datos que se ejecutan en plataformas Linux, UNIX y Windows.

USERID necesita especificar la contraseña de texto no cifrado en el archivo de parámetros o cifrarla con el comando ENCRYPT PASSWORD y, opcionalmente, almacenar una clave de cifrado en un archivo ENCKEYS. USERID soporta una amplia gama de bases de datos que soporta Oracle GoldenGate. Además, admite el uso de una conexión al sistema operativo para Oracle AI Database.

Requisitos de USERIDALIAS por tipo de base de datos

El uso de USERIDALIAS varía según el tipo de base de datos. Nota: La conexión que necesita un usuario y una contraseña de base de datos se debe almacenar en el almacén de credenciales de Oracle GoldenGate.

El USERID especificado soportado en USERIDALIAS en Oracle GoldenGate con MySQL MA es:

• user/db

• user@host/db

• user@host:port/db

Si un usuario de Oracle GoldenGate puede modificar o agregar un USERIDALIAS que no siga ninguno de los patrones anteriores, el usuario verá el error en la coincidencia de patrones en el cliente, como el cliente de interfaz web de MA o el cliente de administración.

DB2 para LUW

Utilice el parámetro USERIDALIAS para todos los procesos de Oracle GoldenGate que se conectan a una base de datos LUW Db2 mediante la autenticación de base de datos.

MySQL

Utilice USERIDALIAS para todos los procesos de Oracle GoldenGate que se conectan a una base de datos MySQL.

Oracle

Utilice USERIDALIAS para los procesos de Oracle GoldenGate que se conectan a una instancia de Oracle AI Database.

• Especifique el alias de una credencial de base de Datos que está almacenada en el almacén del mismo.

• Se necesitan privilegios especiales de base de datos para el usuario USERIDALIAS cuando Extract está configurado para utilizar LOGRETENTION. Estos privilegios se pueden haber otorgado cuando se instaló Oracle GoldenGate. Consulte Configuración de Propiedades de Registro para obtener más información sobre LOGRETENTION.

• Para utilizar USERIDALIAS para un grupo de Extract configurado para la captura integrada, el usuario debe tener privilegios. Si se utiliza Oracle AI Database 26ai y superior, los privilegios de usuario se pueden otorgar con los roles de usuario OGG_CAPTURE y OGG_APPLY. Si utiliza la base de datos Oracle 21c o inferior, el usuario debe tener privilegios en el procedimiento dbms_goldengate_auth.grant_admin_privilege. El usuario debe ser el mismo que emite DBLOGIN y REGISTER EXTRACT o UNREGISTER EXTRACT para el grupo Extract asociado a este USERIDALIAS.

  Para obtener más información sobre la concesión de privilegios de usuario de Oracle AI Database 26ai, consulte Grant User Privileges for Oracle AI Database 26ai and more.

  Para obtener más información sobre la concesión de privilegios para Oracle Database 21c y versiones inferiores, consulte Otorgar privilegios de usuario para Oracle Database 21c y versiones inferiores.

USERIDALIAS con autenticación Kerberos

Solo se admite para Oracle AI Database.

Debe definir ALTER CREDENTIALSTORE para utilizar la palabra clave NOPASSWORD, ya que la autenticación es externa. Consulte ALTER CREDENTIALSTORE para obtener más información.

SQL Server

Utilice USERIDALIAS si la conexión de origen de datos ODBC que utilizará el proceso de Oracle GoldenGate está configurada para conectarse mediante la autenticación de SQL Server.

Teradata

Utilice USERIDALIAS para los procesos de Oracle GoldenGate que se conectan a una base de datos Teradata.

Valor por defecto

Ninguno

Sintaxis

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

<alias>

Especifica el alias de una credencial de usuario de base de datos que está almacenada en el almacén de credenciales de Oracle GoldenGate.

DOMAIN <domain>

Especifica el dominio del almacén de credenciales para el alias especificado. Debe existir una entrada de dominio válida en el almacén de credenciales para el alias especificado.

SYSDBA

(Oracle) Especifica que el usuario se conecta como sysdba.

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

Válido para Replicat. Enlaza la credencial especificada con uno o más threads de un Replicat coordinado. Permite especificar diferentes inicios de sesión para diferentes threads.

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

Especifica un thread ID o una lista delimitada por comas de threads con el formato threadID, threadID, threadID.

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

Especifica un rango de threads con el formato de threadIDlow-threadIDhigh o una lista de rangos delimitados por comas con el formato de threadIDlow-threadIDhigh, threadIDlow-threadIDhigh.

Se permiten una combinación de estos formatos, como threadID, threadID, threadIDlow-threadIDhigh.

TimesTen

Utilice USERIDALIAS para los procesos de Oracle GoldenGate que se conectan a una base de datos TimesTen.

Valor por defecto

Ninguno

Sintaxis

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

<alias>

Especifica el alias de una credencial de usuario de base de datos que está almacenada en el almacén de credenciales de Oracle GoldenGate.

DOMAIN <domain>

Especifica el dominio del almacén de credenciales para el alias especificado. Debe existir una entrada de dominio válida en el almacén de credenciales para el alias especificado.

SYSDBA

(Oracle) Especifica que el usuario se conecta como sysdba.

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

Válido para Replicat. Enlaza la credencial especificada con uno o más threads de un Replicat coordinado. Permite especificar diferentes inicios de sesión para diferentes threads.

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

Especifica un thread ID o una lista delimitada por comas de threads con el formato threadID, threadID, threadID.

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

Especifica un rango de threads con el formato de threadIDlow-threadIDhigh o una lista de rangos delimitados por comas con el formato de threadIDlow-threadIDhigh, threadIDlow-threadIDhigh.

Se permiten una combinación de estos formatos, como threadID, threadID, threadIDlow-threadIDhigh.

Ejemplos

Ejemplo 1

A continuación se proporciona una credencial para el usuario en el almacén de credenciales que tiene el alias tiger1 en el dominio de east.

USERIDALIAS tiger1 DOMAIN east

Ejemplo 2

A continuación, se proporciona una credencial para el thread 3 de un Replicat coordinado.

USERIDALIAS tiger1 DOMAIN east THREADS (3)

Ejemplo 3

En el siguiente ejemplo se muestra el uso del parámetro en PostgreSQL:

USERIDALIAS pgdsn

El siguiente ejemplo muestra el uso de la autenticación de Kerberos con el cliente de administración de Oracle GoldenGate:

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

En este ejemplo, el almacén de credenciales se ha configurado previamente mediante el comando ALTER CREDENTIALSTORE.