Datenbankverbindung vorbereiten
Oracle GoldenGate for Yugabyte (Variante PostgreSQL) stellt über einen vordefinierten ODBC-Treiber eine Verbindung zu Yugabyte-Datenbanken her. Verbindungen können mit einem Data Source Name (DSN) oder über eine direkte Verbindung hergestellt und Host, Port, Datenbank und andere Informationen des Datenbankservers bereitgestellt werden.
Für die Verwendung von DSN-Verbindungen müssen Verbindungsdetails in einer odbc.ini-Datei aufgeführt werden, während Direkteinträge manuell eingegeben werden, wenn eine Datenbankverbindung über die Webschnittstelle oder über den Admin-Client hinzugefügt wird.
Hinweis: PgBouncer wird für Oracle GoldenGate-Verbindungen nicht unterstützt.
Hinweis: Oracle GoldenGate unterstützt keine Verbindungen zu Yugabyte, die Pgpool verwenden.
Nachdem Sie die folgenden Schritte ausgeführt haben, um die DSN-Einträge zu erstellen, oder wenn Sie direkte Verbindungen verwenden möchten, fahren Sie mit dem Thema Datenbankverbindungen hinzufügen fort, um zu erfahren, wie Sie Datenbankverbindungen erstellen.
DSN-basierte Verbindung einrichten
Um eine DSN-Verbindung für Oracle GoldenGate-Prozesse zu erstellen, müssen Sie zunächst eine Umgebungsvariable für das Deployment von Oracle GoldenGate für Yugabyte hinzufügen und dann eine odbc.ini-Datei erstellen, in der die Verbindungsattribute gespeichert werden.
-
Melden Sie sich bei der Service Manager-Webbenutzeroberfläche an.
-
Klicken Sie im linken Navigationsbereich auf Deployments, und wählen Sie den Deployment-Namen für Yugabyte aus. Dadurch werden die verschiedenen Einstellungen für das Deployment erweitert.
-
Klicken Sie auf Konfiguration und dann auf das Pluszeichen (+) neben Umgebungsvariablen.
-
Geben Sie die folgenden Informationen in den beiden verfügbaren Feldern an. Stellen Sie für das Feld Umgebungsvariablenwert sicher, dass es sich um den absoluten Pfad der Datei
odbc.inihandelt:Name der Umgebungsvariablen =
ODBCINIUmgebungsvariablenwert =
/ogg/deployment/yugabyte/odbc.ini -
Klicken Sie auf Weiterleiten, um die neue Variable zu erstellen und das Deployment dann im Bereich Deployments neu zu starten, damit die Änderungen wirksam werden.
-
Erstellen Sie im Ordner
deploymentder Oracle GoldenGate-Installation manuell eineodbc.ini-Datei, und fügen Sie Datenquellen in dieser Datei hinzu.
Verwenden Sie die folgenden Mindesteinstellungen beim Erstellen der DSN-Datei:
-
Data Source Name: Ein benutzerdefinierter Name einer Quell- oder Zieldatenbankverbindung, die von Oracle GoldenGate-Prozessen wie Extract oder Replicat referenziert wird. DSN-Namen dürfen bis zu 32 alphanumerische Zeichen lang sein und dürfen nur Unterstriche (_) und Bindestriche (-) aus Sonderzeichen enthalten. -
IANAAppCodePage=4: Ist die Standardeinstellung, kann jedoch gemäß den Anweisungen auf der Seite https://docs.progress.com/bundle/datadirect-connect-odbc-71/page/IANAAppCodePage_9.html#IANAAppCodePage_9 geändert werden, wenn der Datenbankzeichensatz nicht Unicode ist. -
InstallDir– Ist der Name des Oracle GoldenGate PostgreSQL Wire-Protokolltreiberpfads und kann einen relativen Pfad verwenden, wie:InstallDir =./datadirect -
Driver: Ist der Name der Oracle GoldenGate-Treiberdatei PostgreSQL Wire Protocol und kann einen relativen Pfad verwenden, wie:Driver=./datadirect/lib/ggpsql25.so. -
Database: Dies ist der Name der Quell- oder Zieldatenbank. -
Hostname: Dies ist die IP-Adresse oder der Hostname des Datenbankhosts. -
PortNumber: Dies ist der Listening-Port der Datenbank. -
Oracle GoldenGate für Yugabyte unterstützt mehrere Hosts und Ports für Yugabyte-Verbindungen. Diese Funktion ist im Oracle GoldenGate High Availability-(HA-)Setup nützlich. In einem Yugabyte-HA-Setup gibt es einen primären und mehrere Standby-Server. Sie können das Format der Verbindungszeichenfolge so einrichten, dass mehrere Hosts angegeben werden:
Verbindungszeichenfolge Beschreibung db-user@host1,host2,host3/db-nameDie Verbindungen werden mit dem Yugabyte-Standarddatenbankport 5433 für alle Hosts ( host1,host2,host3) versucht.db-user@host1:1234,host2:2345,host3:3456/db-nameDie Verbindungen werden über die Ports versucht, die mit jedem Host verknüpft sind, der in der Verbindungszeichenfolge angegeben ist. db-user@host1,host2,host3:1234/db-nameAlle Hosts, die dieselbe Portnummer (1234) auf allen Hosts verwenden ( host1,host2,host3). Die Verbindungen werden mit Port 1234 für alle Hosts (host1,host2,host3) versucht.db-user@host1,host2,host3:1234/db-nameAlle Hosts, die dieselbe Portnummer (1234) auf allen Hosts verwenden ( host1,host2,host3). Es wird versucht, die Verbindungen über Port 1234 für alle Hosts herzustellen.db-user@host1:3456,host2,host3:1234/db-nameWenn die Verbindungszeichenfolge in anderen Formaten angegeben wird, in denen die Portnummer für einige Hosts angegeben wird, während die anderen Hosts ohne Ports angegeben werden, wird die letzte oder die höchste Portspezifikation als Portnummer für alle Hosts verwendet, für die keine Portnummer in der Verbindungszeichenfolge angegeben ist. Wie in der Verbindungszeichenfolge dargestellt:
db-user@host1:3456,host2,host3:1234/db-nameDie Portnummer für
host2ist 1234. Dies ist die in der Verbindungszeichenfolge angegebene Portnummer ganz rechts. -
Sie können auch
LogonIDundPasswordfür den Extract- oder Replicat-Benutzer angeben. Diese werden jedoch in Klartext gespeichert. Es wird empfohlen, diese Felder aus dem DSN zu lassen und stattdessen im Oracle GoldenGate-Wallet als Zugangsdatenalias zu speichern und sie mit dem ParameterUSERIDALIASin Extract und Replicat zu referenzieren.
Im Folgenden finden Sie eine odbc.ini-Beispieldatei mit zwei DSN-Einträgen. Die im folgenden Beispiel verwendeten Datenquellennamen sind PG_src und PG_tgt.
|
|
| — |
|
-
Speichern Sie die Datei
odbc.ini, und schließen Sie sie. -
Informationen zum Einrichten der Datenbankverbindung von Oracle GoldenGate für ein Yugabyte-Deployment finden Sie unter Datenbankverbindungen hinzufügen.