USERIDALIAS

Gültig für

Extract, Replicat, DEFGEN, Admin-Client.

Unterstützt für

Alle unterstützten Datenbanken für das Release.

Beschreibung

Verwenden Sie den Parameter USERIDALIAS, um die Authentifizierung für einen Oracle GoldenGate-Prozess anzugeben, der beim Anmelden bei einer Datenbank verwendet werden soll. Für die Verwendung von USERIDALIAS ist die Verwendung eines Oracle GoldenGate-Zugangsdatenspeichers erforderlich. Geben Sie USERIDALIAS vor TABLE- oder MAP-Einträgen in der Parameterdatei an. Die Berechtigungen, die für den Benutzer USERIDALIAS erforderlich sind, variieren je nach Datenbank.

Die folgenden Regeln gelten für den Wert von <alias>:

• Kann maximal 30 Zeichen enthalten

• Muss mit einem Buchstaben beginnen

• Kann eine beliebige Kombination aus Buchstaben, Zahlen und folgenden Sonderzeichen enthalten:

  • $-Zeichen (Dollar)

  • _ (Unterstrich)

  • (Hash) Zeichen

USERIDALIAS im Vergleich zu USERID

Mit USERIDALIAS können Sie einen Alias anstelle eines Benutzers ID und eines Kennworts in der Parameterdatei angeben. Die Benutzer-IDs und verschlüsselten Kennwörter werden in einem Zugangsdatenspeicher gespeichert. USERIDALIAS unterstützt Datenbanken, die auf Linux-, UNIX- und Windows-Plattformen laufen.

Für USERID muss entweder das Klartextpasswort in der Parameterdatei angegeben oder mit dem Befehl ENCRYPT PASSWORD verschlüsselt werden. Optional muss ein Verschlüsselungsschlüssel in einer ENCKEYS-Datei gespeichert werden. USERID unterstützt ein breites Spektrum an Datenbanken, die von Oracle GoldenGate unterstützt werden. Darüber hinaus unterstützt es die Verwendung einer Betriebssystemanmeldung für Oracle AI Database.

USERIDALIAS-Anforderungen pro Datenbanktyp

Die Verwendung von USERIDALIAS variiert je nach Datenbanktyp. Hinweis: Eine Anmeldung, für die ein Datenbankbenutzer und ein Kennwort erforderlich sind, muss im Oracle GoldenGate-Zugangsdatenspeicher gespeichert sein.

Die unterstützte angegebene USERID in USERIDALIAS in Oracle GoldenGate mit MySQL MA ist:

• user/db

• user@host/db

• user@host:port/db

Wenn ein Oracle GoldenGate-Benutzer eine USERIDALIAS ändern oder hinzufügen darf, die keinem der vorhergehenden Muster folgt, wird dem Benutzer der Fehler beim Musterabgleich auf dem Client angezeigt, z.B. auf dem MA-Webschnittstellenclient oder Admin-Client.

DB2 für LUW

Verwenden Sie den Parameter USERIDALIAS für alle Oracle GoldenGate-Prozesse, die mit Datenbankauthentifizierung eine Verbindung zu einer Db2-LUW-Datenbank herstellen.

MySQL

Verwenden Sie USERIDALIAS für alle Oracle GoldenGate-Prozesse, die eine Verbindung zu einer MySQL-Datenbank herstellen.

Oracle

Verwenden Sie USERIDALIAS für Oracle GoldenGate-Prozesse, die eine Verbindung zu einer Oracle AI Database herstellen.

• Geben Sie den Alias einer Datenbankzugangsdaten an, die im Oracle GoldenGate-Zugangsdatenspeicher gespeichert ist.

• Spezielle Datenbankberechtigungen sind für den Benutzer USERIDALIAS erforderlich, wenn Extract für die Verwendung von LOGRETENTION konfiguriert ist. Diese Berechtigungen wurden möglicherweise erteilt, als Oracle GoldenGate installiert wurde. Weitere Informationen zu LOGRETENTION finden Sie unter Loggingebenen konfigurieren.

• Um USERIDALIAS für eine Extract-Gruppe zu verwenden, die für den integrierten Capture-Prozess konfiguriert ist, muss der Benutzer über Berechtigungen verfügen. Wenn Sie Oracle AI Database 26ai und höher verwenden, können die Benutzerberechtigungen mit den Benutzerrollen OGG_CAPTURE und OGG_APPLY erteilt werden. Wenn Sie die Oracle-Datenbank 21c oder niedriger verwenden, muss der Benutzer über Berechtigungen in der Prozedur dbms_goldengate_auth.grant_admin_privilege verfügen. Der Benutzer muss derselbe sein, der DBLOGIN und REGISTER EXTRACT oder UNREGISTER EXTRACT für die Extract-Gruppe ausgibt, die mit dieser USERIDALIAS verknüpft ist.

  Einzelheiten zum Erteilen von Oracle AI Database 26ai-Benutzerberechtigungen finden Sie unter Benutzerberechtigungen für Oracle AI Database 26ai und höher erteilen.

  Einzelheiten zum Erteilen von Berechtigungen für Oracle Database 21c und niedriger finden Sie unter Benutzerberechtigungen für Oracle Database 21c und niedriger erteilen.

USERIDALIAS mit Kerberos-Authentifizierung

Wird nur für Oracle AI Database unterstützt.

Sie müssen ALTER CREDENTIALSTORE festlegen, um das Schlüsselwort NOPASSWORD zu verwenden, da die Authentifizierung extern ist. Weitere Informationen finden Sie unter ALTER CREDENTIALSTORE.

SQL Server

Verwenden Sie USERIDALIAS, wenn die ODBC-Datenquellenverbindung, die vom Oracle GoldenGate-Prozess verwendet wird, für die Verbindung mit der SQL Server-Authentifizierung konfiguriert ist.

Teradata

Verwenden Sie USERIDALIAS für Oracle GoldenGate-Prozesse, die eine Verbindung zu einer Teradata-Datenbank herstellen.

Standard

Keine

Syntax

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

<alias>

Gibt den Alias der Benutzerzugangsdaten für die Datenbank an, die im Oracle GoldenGate-Zugangsdatenspeicher gespeichert sind.

DOMAIN <domain>

Gibt die Domain des Zugangsdatenspeichers für den angegebenen Alias an. Der Zugangsdatenspeicher für den angegebenen Alias muss einen gültigen Domaineintrag enthalten.

SYSDBA

(Oracle) Gibt an, dass der Benutzer sich als sysdba anmeldet.

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

Gültig für Replicat. Verknüpft die angegebenen Zugangsdaten mit einem oder mehreren Threads eines koordinierten Replicats. Damit können Sie verschiedene Anmeldungen für verschiedene Threads angeben.

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

Gibt eine Thread-ID oder eine kommagetrennte Liste mit Threads im Format threadID, threadID, threadID an.

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

Gibt einen Threadbereich in Form von threadIDlow-threadIDhigh oder einer durch Komma getrennten Liste von Bereichen im Format von threadIDlow-threadIDhigh, threadIDlow-threadIDhigh an.

Eine Kombination aus diesen Formaten ist ebenfalls zulässig, wie threadID, threadID, threadIDlow-threadIDhigh.

TimesTen

Verwenden Sie USERIDALIAS für Oracle GoldenGate-Prozesse, die eine Verbindung zu einer TimesTen-Datenbank herstellen.

Standard

Keine

Syntax

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

<alias>

Gibt den Alias der Benutzerzugangsdaten für die Datenbank an, die im Oracle GoldenGate-Zugangsdatenspeicher gespeichert sind.

DOMAIN <domain>

Gibt die Domain des Zugangsdatenspeichers für den angegebenen Alias an. Der Zugangsdatenspeicher für den angegebenen Alias muss einen gültigen Domaineintrag enthalten.

SYSDBA

(Oracle) Gibt an, dass der Benutzer sich als sysdba anmeldet.

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

Gültig für Replicat. Verknüpft die angegebenen Zugangsdaten mit einem oder mehreren Threads eines koordinierten Replicats. Damit können Sie verschiedene Anmeldungen für verschiedene Threads angeben.

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

Gibt eine Thread-ID oder eine kommagetrennte Liste mit Threads im Format threadID, threadID, threadID an.

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

Gibt einen Threadbereich in Form von threadIDlow-threadIDhigh oder einer durch Komma getrennten Liste von Bereichen im Format von threadIDlow-threadIDhigh, threadIDlow-threadIDhigh an.

Eine Kombination aus diesen Formaten ist zulässig, wie threadID, threadID, threadIDlow-threadIDhigh.

Beispiele

Beispiel 1

Im Folgenden werden Zugangsdaten für den Benutzer im Zugangsdatenspeicher bereitgestellt, der den Alias tiger1 in der Domain east aufweist.

USERIDALIAS tiger1 DOMAIN east

Beispiel 2

Im Folgenden werden Zugangsdaten für Thread 3 eines koordinierten Replicats bereitgestellt.

USERIDALIAS tiger1 DOMAIN east THREADS (3)

Beispiel 3

Das folgende Beispiel zeigt die Verwendung des Parameters in PostgreSQL:

USERIDALIAS pgdsn

Das folgende Beispiel zeigt die Verwendung der Kerberos-Authentifizierung mit dem Oracle GoldenGate-Admin-Client:

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

In diesem Beispiel wird der Zugangsdatenspeicher zuvor mit dem Befehl ALTER CREDENTIALSTORE eingerichtet.