USERIDALIAS

Valido per

Extract, Replicat, DEFGEN, Client di amministrazione.

Supportato per

Tutti i database supportati per la release.

Descrizione

Utilizzare il parametro USERIDALIAS per specificare l'autenticazione per un processo Oracle GoldenGate da utilizzare quando si esegue il login a un database. L'uso di USERIDALIAS richiede l'uso di un'area di memorizzazione delle credenziali Oracle GoldenGate. Specificare USERIDALIAS prima di qualsiasi voce TABLE o MAP nel file dei parametri. I privilegi richiesti per l'utente USERIDALIAS variano in base al database.

Al valore di <alias> si applicano le regole riportate di seguito.

• Può avere una lunghezza massima di 30 caratteri

• Deve iniziare con un carattere alfabetico

• Può includere qualsiasi combinazione di lettere, numeri e i seguenti caratteri speciali:

  • Simbolo $ (dollaro)

  • _ (carattere di sottolineatura)

  • (hash) segno

USERIDALIAS Rispetto all'USERID

USERIDALIAS consente di specificare un alias, anziché un utente ID e una password, nel file dei parametri. Gli ID utente e le password cifrate vengono memorizzati in un'area di memorizzazione delle credenziali. USERIDALIAS supporta i database in esecuzione su piattaforme Linux, UNIX e Windows.

USERID richiede di specificare la password di testo in chiaro nel file dei parametri o di cifrarla con il comando ENCRYPT PASSWORD e, facoltativamente, di memorizzare una chiave di cifratura in un file ENCKEYS. USERID supporta un'ampia gamma di database supportati da Oracle GoldenGate. Inoltre, supporta l'uso di un login al sistema operativo per Oracle AI Database.

Requisiti USERIDALIAS per tipo di database

L'uso di USERIDALIAS varia a seconda del tipo di database. Nota: il login che richiede un utente e una password del database deve essere memorizzato nell'area di memorizzazione delle credenziali di Oracle GoldenGate.

L'indirizzo USERID specificato supportato in USERIDALIAS in Oracle GoldenGate con MySQL MA è:

• user/db

• user@host/db

• user@host:port/db

Se a un utente di Oracle GoldenGate è consentito modificare o aggiungere un USERIDALIAS che non segue alcuno dei pattern precedenti, l'utente visualizzerà l'errore nella corrispondenza dei pattern sul client, ad esempio il client dell'interfaccia Web MA o il client di amministrazione.

DB2 per LUW

Utilizzare il parametro USERIDALIAS per tutti i processi Oracle GoldenGate che si connettono a un database LUW Db2 utilizzando l'autenticazione del database.

MySQL

Utilizzare USERIDALIAS per tutti i processi Oracle GoldenGate che si connettono a un database MySQL.

Oracle

Utilizza USERIDALIAS per i processi Oracle GoldenGate che si connettono a un Oracle AI Database.

• Specificare l'alias di una credenziale del database memorizzata nell'area di memorizzazione delle credenziali di Oracle GoldenGate.

• Per l'utente USERIDALIAS sono necessari privilegi di database speciali quando Extract è configurato per l'uso di LOGRETENTION. Questi privilegi potrebbero essere stati concessi quando è stato installato Oracle GoldenGate. Per ulteriori informazioni su LOGRETENTION, vedere Configura proprietà di log.

• Per utilizzare USERIDALIAS per un gruppo Extract configurato per l'acquisizione integrata, l'utente deve disporre dei privilegi necessari. Se si utilizza Oracle AI Database 26ai e versioni successive, i privilegi utente possono essere concessi con i ruoli utente OGG_CAPTURE e OGG_APPLY. Se si utilizza il database Oracle 21c o versione precedente, l'utente deve disporre dei privilegi nella procedura dbms_goldengate_auth.grant_admin_privilege. L'utente deve essere lo stesso che emette DBLOGIN e REGISTER EXTRACT o UNREGISTER EXTRACT per il gruppo Extract associato a questo USERIDALIAS.

  Per i dettagli sulla concessione dei privilegi utente di Oracle AI Database 26ai, vedere Concedi privilegi utente per Oracle AI Database 26ai e versioni successive.

  Per i dettagli sulla concessione dei privilegi per Oracle Database 21c e versioni successive, vedere Concedi privilegi utente per Oracle Database 21c e versioni successive.

USERIDALIAS con autenticazione Kerberos

Supportato solo per Oracle AI Database.

È necessario impostare ALTER CREDENTIALSTORE per utilizzare la parola chiave NOPASSWORD poiché l'autenticazione è esterna. Per ulteriori informazioni, visita il sito ALTER CREDENTIALSTORE.

SQL Server

Utilizzare USERIDALIAS se la connessione all'origine dati ODBC che verrà utilizzata dal processo Oracle GoldenGate è configurata per la connessione mediante l'autenticazione SQL Server.

Teradata

Utilizzare USERIDALIAS per i processi Oracle GoldenGate che si connettono a un database Teradata.

Predefinito

Nessuno

Sintassi

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

<alias>

Specifica l'alias di una credenziale utente del database memorizzata nell'area di memorizzazione delle credenziali di Oracle GoldenGate.

DOMAIN <domain>

Specifica il dominio dell'area di memorizzazione delle credenziali per l'alias specificato. Una voce di dominio valida deve esistere nell'area di memorizzazione delle credenziali per l'alias specificato.

SYSDBA

(Oracle) Specifica che l'utente esegue il login come sysdba.

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

Valido per Replicat. Collega le credenziali specificate a uno o più thread di un Replicat coordinato. Consente di specificare credenziali diverse per thread diversi.

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

Specifica un thread ID o una lista separata da virgole di thread nel formato threadID, threadID, threadID.

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

Specifica un intervallo di thread in formato threadIDlow-threadIDhigh o una lista di intervalli separata da virgole nel formatothreadIDlow-threadIDhigh, threadIDlow-threadIDhigh.

La combinazione di questi formati, ad esempio threadID, threadID, threadIDlow-threadIDhigh, è consentita.

TimesTen

Utilizzare USERIDALIAS per i processi Oracle GoldenGate che si connettono a un database TimesTen.

Predefinito

Nessuno

Sintassi

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

<alias>

Specifica l'alias di una credenziale utente del database memorizzata nell'area di memorizzazione delle credenziali di Oracle GoldenGate.

DOMAIN <domain>

Specifica il dominio dell'area di memorizzazione delle credenziali per l'alias specificato. Una voce di dominio valida deve esistere nell'area di memorizzazione delle credenziali per l'alias specificato.

SYSDBA

(Oracle) Specifica che l'utente esegue il login come sysdba.

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

Valido per Replicat. Collega le credenziali specificate a uno o più thread di un Replicat coordinato. Consente di specificare credenziali diverse per thread diversi.

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

Specifica un thread ID o una lista separata da virgole di thread nel formato threadID, threadID, threadID.

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

Specifica un intervallo di thread in formato threadIDlow-threadIDhigh o una lista di intervalli separata da virgole nel formatothreadIDlow-threadIDhigh, threadIDlow-threadIDhigh.

La combinazione di questi formati, ad esempio threadID, threadID, threadIDlow-threadIDhigh, è consentita.

Esempi

Esempio 1

Di seguito viene fornita una credenziale per l'utente nell'area di memorizzazione delle credenziali con l'alias tiger1 nel dominio di east.

USERIDALIAS tiger1 DOMAIN east

Esempio 2

Di seguito viene fornita una credenziale per il thread 3 di un Replicat coordinato.

USERIDALIAS tiger1 DOMAIN east THREADS (3)

Esempio 3

L'esempio seguente mostra l'uso del parametro in PostgreSQL:

USERIDALIAS pgdsn

L'esempio riportato di seguito mostra l'uso dell'autenticazione Kerberos con il client di amministrazione Oracle GoldenGate.

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

In questo esempio, l'area di memorizzazione delle credenziali è stata impostata in precedenza utilizzando il comando ALTER CREDENTIALSTORE.