USERIDALIAS

Durée de validité

Extrayez, répliquez, DEFGEN, Admin Client.

Pris en charge pour

Toutes les bases de données prises en charge pour la version.

Description

Utilisez le paramètre USERIDALIAS pour indiquer l'authentification d'un processus Oracle GoldenGate à utiliser lors de la connexion à une base de données. L'utilisation de USERIDALIAS nécessite l'utilisation d'une banque d'informations d'identification Oracle GoldenGate. Indiquez USERIDALIAS avant toute entrée TABLE ou MAP dans le fichier de paramètres. Les privilèges requis pour l'utilisateur USERIDALIAS varient selon la base de données.

Les règles suivantes s'appliquent à la valeur de <alias> :

• Il peut comporter jusqu'à 30 caractères

• Doit commencer par une lettre

• Peut inclure n'importe quelle combinaison de lettres, de chiffres et de caractères spéciaux suivants :

  • $ (signe dollar)

  • _ (trait de soulignement)

  • signe (hachage)

USERIDALIAS par rapport à USERID

USERIDALIAS vous permet d'indiquer un alias, plutôt qu'un utilisateur ID et un mot de passe, dans le fichier de paramètres. Les ID utilisateur et les mots de passe cryptés sont stockés dans une banque d'informations d'identification. USERIDALIAS prend en charge les bases de données exécutées sur les plates-formes Linux, UNIX et Windows.

USERID nécessite de spécifier le mot de passe en texte clair dans le fichier de paramètres ou de le crypter à l'aide de la commande ENCRYPT PASSWORD et, éventuellement, de stocker une clé de cryptage dans un fichier ENCKEYS. USERID prend en charge un large éventail de bases de données prises en charge par Oracle GoldenGate. En outre, il prend en charge l'utilisation d'une connexion au système d'exploitation pour Oracle AI Database.

Exigences USERIDALIAS par type de base de données

L'utilisation de USERIDALIAS varie en fonction du type de base de données. Remarque : la connexion nécessitant un utilisateur et un mot de passe de base de données doit être stockée dans la banque d'informations d'identification Oracle GoldenGate.

Les éléments USERID indiqués pris en charge dans USERIDALIAS dans Oracle GoldenGate avec MySQL MA sont les suivants :

• user/db

• user@host/db

• user@host:port/db

Si un utilisateur Oracle GoldenGate est autorisé à modifier ou à ajouter un élément USERIDALIAS qui ne suit aucun des modèles précédents, l'utilisateur verra l'erreur de correspondance de modèle sur le client, tel que le client d'interface Web MA ou le client d'administration.

DB2 pour LUW

Utilisez le paramètre USERIDALIAS pour tous les processus Oracle GoldenGate qui se connectent à une base de données Db2 LUW à l'aide de l'authentification de base de données.

MySQL

Utilisez USERIDALIAS pour tous les processus Oracle GoldenGate qui se connectent à une base de données MySQL.

Oracle

Utilisez USERIDALIAS pour les processus Oracle GoldenGate qui se connectent à une instance Oracle AI Database.

• Indiquez l'alias d'une information d'identification de base de données stockée dans la banque d'informations d'identification Oracle GoldenGate.

• Des privilèges de base de données spéciaux sont requis pour l'utilisateur USERIDALIAS lorsque l'extraction est configurée pour utiliser LOGRETENTION. Ces privilèges peuvent avoir été accordés lors de l'installation d'Oracle GoldenGate. Pour plus d'informations sur LOGRETENTION, reportez-vous à Configuration des propriétés de journalisation.

• Pour utiliser USERIDALIAS pour un groupe d'extraction configuré pour la capture intégrée, l'utilisateur doit disposer de privilèges. Si vous utilisez Oracle AI Database 26ai et versions ultérieures, les privilèges utilisateur peuvent être accordés avec les rôles utilisateur OGG_CAPTURE et OGG_APPLY. Si vous utilisez la base de données Oracle 21c ou une version inférieure, l'utilisateur doit disposer de privilèges dans la procédure dbms_goldengate_auth.grant_admin_privilege. L'utilisateur doit être le même que celui qui émet DBLOGIN et REGISTER EXTRACT ou UNREGISTER EXTRACT pour le groupe d'extraction associé à ce USERIDALIAS.

  Pour plus de détails sur l'octroi de privilèges utilisateur Oracle AI Database 26ai, reportez-vous à Octroi de privilèges utilisateur pour Oracle AI Database 26ai et versions supérieures.

  Pour plus d'informations sur l'octroi de privilèges pour Oracle Database 21c et versions inférieures, reportez-vous à Octroi de privilèges utilisateur pour Oracle Database 21c et versions inférieures.

USERIDALIAS avec authentification Kerberos

Prise en charge pour Oracle AI Database uniquement.

Vous devez définir ALTER CREDENTIALSTORE pour utiliser le mot-clé NOPASSWORD car l'authentification est externe. Pour en savoir plus, reportez-vous à ALTER CREDENTIALSTORE.

SQL Server

Utilisez USERIDALIAS si la connexion à la source de données ODBC qui sera utilisée par le processus Oracle GoldenGate est configurée pour la connexion à l'aide de l'authentification SQL Server.

Teradata

Utilisez USERIDALIAS pour les processus Oracle GoldenGate qui se connectent à une base de données Teradata.

Valeur par défaut

Aucun

Syntaxe

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

<alias>

Indique l'alias des informations d'identification d'un utilisateur de base de données stockées dans la banque d'informations d'identification Oracle GoldenGate.

DOMAIN <domain>

Indique le domaine de banque d'informations d'identification pour l'alias spécifié. Une entrée de domaine valide doit exister dans la banque d'informations d'identification pour l'alias spécifié.

SYSDBA

(Oracle) Indique que l'utilisateur se connecte en tant que sysdba.

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

Valide pour la réplication. Relie les informations d'identification indiquées aux threads d'une réplication coordonnée. Permet de spécifier des connexions différentes pour différents threads.

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

Indique un thread ID ou une liste de threads séparés par une virgule au format threadID, threadID, threadID.

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

Indique une plage de threads au formatthreadIDlow-threadIDhigh ou une liste de plages délimitées par une virgule au formatthreadIDlow-threadIDhigh, threadIDlow-threadIDhigh.

Vous pouvez combiner ces formats. Par exemple, threadID, threadID, threadIDlow-threadIDhigh.

TimesTen

Utilisez USERIDALIAS pour les processus Oracle GoldenGate qui se connectent à une base de données TimesTen.

Valeur par défaut

Aucun

Syntaxe

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

<alias>

Indique l'alias des informations d'identification d'un utilisateur de base de données stockées dans la banque d'informations d'identification Oracle GoldenGate.

DOMAIN <domain>

Indique le domaine de banque d'informations d'identification pour l'alias spécifié. Une entrée de domaine valide doit exister dans la banque d'informations d'identification pour l'alias spécifié.

SYSDBA

(Oracle) Indique que l'utilisateur se connecte en tant que sysdba.

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

Valide pour la réplication. Relie les informations d'identification indiquées aux threads d'une réplication coordonnée. Permet de spécifier des connexions différentes pour différents threads.

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

Indique un thread ID ou une liste de threads séparés par une virgule au format threadID, threadID, threadID.

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

Indique une plage de threads au formatthreadIDlow-threadIDhigh ou une liste de plages délimitées par une virgule au formatthreadIDlow-threadIDhigh, threadIDlow-threadIDhigh.

Vous pouvez combiner ces formats. Par exemple, threadID, threadID, threadIDlow-threadIDhigh.

Exemples

Exemple 1

Les informations d'identification suivantes fournissent à l'utilisateur de la banque d'informations d'identification l'alias tiger1 dans le domaine de east.

USERIDALIAS tiger1 DOMAIN east

Exemple 2

Les informations d'identification suivantes sont fournies pour le thread 3 d'une réplication coordonnée.

USERIDALIAS tiger1 DOMAIN east THREADS (3)

Exemple 3

L'exemple suivant illustre l'utilisation du paramètre dans PostgreSQL :

USERIDALIAS pgdsn

L'exemple suivant illustre l'utilisation de l'authentification Kerberos avec le client d'administration Oracle GoldenGate :

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

Dans cet exemple, la banque d'informations d'identification est précédemment configurée à l'aide de la commande ALTER CREDENTIALSTORE.