Prepara connessione al database

Informazioni sulla configurazione delle impostazioni di connessione al database, sistema e parametri per Oracle GoldenGate per SQL Server.

Oracle GoldenGate for SQL Server si connette ai database di SQL Server 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 all'interfaccia Web del servizio di amministrazione o tramite il client di amministrazione.

Configurare una connessione DSN in Linux

I passaggi seguenti illustrano come creare una connessione DSN su Linux utilizzando un file odbc.ini.

Per le versioni di Oracle GoldenGate precedenti alla 23.6, è innanzitutto necessario aggiungere una nuova variabile di ambiente ODBCINI per la distribuzione di SQL Server utilizzando i passi riportati di seguito. Le versioni che iniziano con la 23.6 impostano automaticamente questa variabile durante la creazione della distribuzione.
1. Eseguire il login all'interfaccia Web Service Manager.
2. Nel riquadro di navigazione a sinistra fare clic su Distribuzioni, quindi selezionare la distribuzione di Oracle GoldenGate SQL Server. 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_HOME)/msodbc/odbc.ini
5. Fare clic su Sottometti per creare la nuova variabile, quindi riavviare la distribuzione dal riquadro Distribuzioni per rendere effettive le modifiche.
Nella cartella msodbc dell'installazione di Oracle GoldenGate, creare manualmente un file odbc.ini e aggiungere origini dati in questo file utilizzando le informazioni e l'esempio riportati di seguito.

Esempio per le versioni di Oracle GoldenGate precedenti alla 23.6, dove Driver deve essere impostato su 'Driver ODBC 18 per SQL Server'
```
[mssql_source]
Driver = ODBC Driver 18 for SQL Server
Server = myserver,1433
Database = source_database
TrustServerCertificate=yes
```
Esempio per Oracle GoldenGate versioni 23.6 o successive, dove Driver deve essere impostato su 'Driver Microsoft ODBC per SQL Server'
```
[mssql_source]
Driver = Microsoft ODBC Driver for SQL Server
Server = myserver,1433
Database = source_database
TrustServerCertificate=yes
```

Nota: per un elenco completo delle opzioni di connessione disponibili, consultare la documentazione di Microsoft al seguente collegamento: https://learn.microsoft.com/en-us/sql/connect/odbc/dsn-connection-string-attribute?view=sql-server-ver16

Salvare e chiudere il file odbc.ini.
Per creare la connessione al database per la distribuzione, vedere Aggiungi connessioni al database.

Configurare una connessione DSN in Windows

Prima di creare una connessione al database per i processi Oracle GoldenGate in esecuzione su Windows, installare la versione più recente di Microsoft ODBC Driver 17 per SQL Server o Microsoft ODBC Driver 18 per SQL Server.

Per creare un DSN di sistema sul server Windows in cui è installato Oracle GoldenGate, attenersi alla procedura riportata di seguito.

Per creare un DSN di SQL Server:

Aprire l'applicazione Origini dati ODBC (64 bit).
Nella finestra di dialogo Amministratore origini dati ODBC, selezionare la scheda DSN di sistema, quindi fare clic su Aggiungi.
In Crea nuova origine dati selezionare il driver ODBC {version} per SQL Server, quindi fare clic su Fine. Viene visualizzata la procedura guidata Crea nuova origine dati in SQL Server.
Immettere i dettagli riportati di seguito e fare clic su Avanti.
- Nome: Può essere di vostra scelta. In un cluster Windows, utilizzare un nome su tutti i nodi del cluster.
- Descrizione: (facoltativo) digitare una descrizione dell'origine dati.
- Server: digitare la stringa di connessione o il nome\istanza del server SQL Server. Per le connessioni Always On, utilizzare il nome\istanza del listener del gruppo di disponibilità Always On.
Per l'autenticazione del login, selezionare Autenticazione SQL Server, specificare le informazioni ID login e Password, quindi fare clic su Successivo.
Se si configura una connessione utilizzando il driver Microsoft ODBC 18 per SQL Server, fare di nuovo clic su Avanti per passare all'ultima pagina di configurazione. Selezionare l'opzione Certificato server sicuro, quindi fare clic su Indietro per procedere poiché è necessario abilitare il certificato server sicuro prima di selezionare il database predefinito nel passo successivo.
Selezionare Modifica database predefinito in, quindi selezionare il database di origine o di destinazione dalla lista. Abilitare le impostazioni Usa ANSI e fare clic su Successivo.
Lasciare invariata la pagina successiva della procedura guidata e fare clic su Fine.
Fare clic su Test origine dati per eseguire il test della connessione.
Se il test riesce, chiudere la casella di conferma e la casella Crea nuova origine dati.
Ripetere questa procedura per ogni database di origine e destinazione di SQL Server, in cui verrà eseguita la connessione del processo Oracle GoldenGate.

Connessione al listener di una configurazione Always On di SQL Server

Extract e Replicat possono connettersi al listener di una configurazione Sempre attivo o direttamente alla replica primaria corrente del gruppo.

Il vantaggio della creazione della connessione al listener è che Extract o Replicat possono riconnettersi alla nuova replica primaria al failover senza dover riconfigurare la stringa di connessione al nuovo primario.

È inoltre possibile configurare Extract per instradare le query di sola lettura a una replica secondaria in modalità sincrona leggibile disponibile. Per impostazione predefinita, se Extract si connette a un listener, tutte le elaborazioni verranno eseguite sulla replica primaria, ma se un Extract è configurato con il parametro TRANLOGOPTIONS ALWAYSONREADONLYROUTING, le query di sola lettura vengono instradate dal listener a una replica secondaria leggibile disponibile.

Per ulteriori informazioni, vedere TRANLOGOPTIONS e Riepilogo dei requisiti per l'acquisizione e la distribuzione dei database in un gruppo di disponibilità Always On.

Se si crea il DSN per connettersi a un listener di una configurazione Sempre attivo, abilitare l'opzione di failover Multi-subnet durante la creazione di un DSN. Per le connessioni DSN Linux, utilizzare l'opzione MultiSubnetFailover=Yes nella voce DSN.