Prepara connessione al database

Oracle GoldenGate for Yugabyte (variante PostgreSQL) si connette ai database Yugabyte utilizzando un driver ODBC preimpostato. Le connessioni possono essere stabilite utilizzando un nome di origine dati (DSN, Data Source Name) o utilizzando una connessione diretta e fornendo l'host, la porta, il database del database server e altre informazioni.

L'utilizzo delle connessioni DSN richiede che i dettagli di connessione siano elencati in un file odbc.ini, mentre l'utilizzo di voci dirette viene immesso manualmente quando si aggiunge una connessione al database dall'interfaccia Web o dal client di amministrazione.

Nota: PgBouncer non è supportato per le connessioni a Oracle GoldenGate.

Nota: Oracle GoldenGate non supporta le connessioni a Yugabyte che utilizzano Pgpool.

Dopo aver eseguito i passi riportati di seguito per creare le voci DSN o si prevede di utilizzare connessioni dirette, passare all'argomento Aggiungi connessioni al database per sapere come creare le connessioni al database.

Impostare una connessione basata su DSN

Per creare una connessione DSN per i processi Oracle GoldenGate, sarà innanzitutto necessario aggiungere una variabile di ambiente per la distribuzione Oracle GoldenGate for Yugabyte, quindi creare un file odbc.ini per memorizzare gli attributi di connessione.

1. Eseguire il login all'interfaccia Web Service Manager.

2. Nel riquadro di navigazione a sinistra, fare clic su Distribuzioni, quindi selezionare il nome della distribuzione per Yugabyte. Ciò espande le varie impostazioni per la distribuzione.

3. Fare clic su Configurazione, quindi sul segno più (+) accanto a Variabili di ambiente.

4. Fornire le seguenti informazioni nei due campi disponibili. Per il campo Valore variabile di ambiente, assicurarsi che sia il percorso assoluto del file odbc.ini:

   Nome variabile di ambiente = ODBCINI

   Valore variabile di ambiente = /ogg/deployment/yugabyte/odbc.ini

5. Fare clic su Sottometti per creare la nuova variabile, quindi riavviare la distribuzione dal riquadro Distribuzioni per rendere effettive le modifiche.

6. Nella cartella deployment dell'installazione di Oracle GoldenGate, creare manualmente un file odbc.ini e aggiungere origini dati in questo file.

Utilizzare le seguenti impostazioni minime durante la creazione del file DSN:

• Data Source Name: nome definito dall'utente di una connessione al database di origine o di destinazione a cui i processi Oracle GoldenGate fanno riferimento, ad esempio Extract o Replicat. I nomi DSN possono avere una lunghezza massima di 32 caratteri alfanumerici e possono includere solo caratteri di sottolineatura (_) e trattini (-) a partire da caratteri speciali.

• IANAAppCodePage=4: è l'impostazione predefinita, ma può essere modificata in base alle indicazioni specificate nella pagina https://docs.progress.com/bundle/datadirect-connect-odbc-71/page/IANAAppCodePage_9.html#IANAAppCodePage_9 quando il set di caratteri del database non è Unicode.

• InstallDir: nome del percorso del driver del protocollo wirePostgreSQL di Oracle GoldenGate e può utilizzare un percorso relativo, ad esempio: InstallDir =./datadirect

• Driver: è il nome del file del driver PostgreSQL Wire Protocol di Oracle GoldenGate e può utilizzare un percorso relativo, ad esempio: Driver=./datadirect/lib/ggpsql25.so.

• Database: nome del database di origine o di destinazione.

• Hostname: è l'indirizzo IP o il nome host dell'host del database.

• PortNumber: è la porta di ascolto del database.

• Oracle GoldenGate per Yugabyte supporta più host e porte per le connessioni Yugabyte. Questa funzione è utile nell'impostazione HA (High Availability) di Oracle GoldenGate. In una configurazione HA di Yugabyte esiste un server primario e più server in standby. È possibile impostare il formato della stringa di connessione per specificare più host:

  Stringa di connessione	Descrizione
  db-user@host1,host2,host3/db-name	Le connessioni verranno tentate utilizzando la porta di database Yugabyte predefinita 5433 per tutti gli host (host1, host2, host3).
  db-user@host1:1234,host2:2345,host3:3456/db-name	Le connessioni vengono tentate utilizzando le porte associate a ciascun host specificato nella stringa di connessione.
  db-user@host1,host2,host3:1234/db-name	Tutti gli host che utilizzano lo stesso numero di porta (1234) su tutti gli host (host1, host2, host3). Le connessioni verranno tentate utilizzando la porta 1234 per tutti gli host (host1, host2, host3).
  db-user@host1,host2,host3:1234/db-name	Tutti gli host che utilizzano lo stesso numero di porta (1234) su tutti gli host (host1, host2, host3). Le connessioni sarebbero tentate utilizzando la porta 1234 per tutti gli host.
  db-user@host1:3456,host2,host3:1234/db-name	Se la stringa di connessione viene specificata in altri formati in cui il numero di porta viene specificato per alcuni host mentre gli altri host vengono specificati senza porte, la specifica dell'ultima porta o dell'ultima porta a destra verrà utilizzata come numero di porta per tutti gli host che non dispongono di un numero di porta specificato nella stringa di connessione. Come mostrato nella stringa di connessione: db-user@host1:3456,host2,host3:1234/db-name Il numero di porta per host2 sarebbe 1234, ovvero il numero di porta più a destra specificato nella stringa di connessione.

• È anche possibile fornire LogonID e Password per l'utente Extract o Replicat, ma questi verranno memorizzati in chiaro. Si consiglia di lasciare questi campi fuori dal DSN e di memorizzarli invece nel wallet Oracle GoldenGate come alias di credenziale e di fare riferimento a tali campi con il parametro USERIDALIAS in Extract e Replicat.

Di seguito è riportato un esempio di file odbc.ini con due voci DSN. I nomi delle origini dati utilizzati nell'esempio seguente sono PG_src e PG_tgt.

#[ODBC Data Sources] [ODBC] IANAAppCodePage=4 InstallDir=/datadirect

[PG_src] Driver= ./datadirect/lib/ggpsql25.so Description=Oracle GoldenGate PostgreSQL Wire Protocol Database=sourcedb HostName=remotehost PortNumber=5432

| — |

[PG_tgt] Driver=./datadirect/lib/ggpsql25.so Description=Oracle GoldenGate PostgreSQL Wire Protocol Database=targetdb HostName=remotehost PortNumber=5432

1. Salvare e chiudere il file odbc.ini.

2. Per impostare la connessione al database da Oracle GoldenGate per una distribuzione di Yugabyte, vedere Aggiungi connessioni al database.