準備資料庫連線
Oracle GoldenGate for Yugabyte (PostgreSQL 變體) 使用預先封裝的 ODBC 驅動程式連線至 Yugabyte 資料庫。可以使用資料來源名稱 (DSN) 建立連線,或使用直接連線並提供資料庫伺服器主機、連接埠、資料庫和其他資訊。
使用 DSN 連線時,必須將連線詳細資訊列在 odbc.ini 檔案中,當從 Web 介面或「管理從屬端」新增資料庫連線時,手動輸入使用直接項目。
注意:Oracle GoldenGate 連線不支援 PgBouncer。
注意:Oracle GoldenGate 不支援連線至使用 Pgpool 的 Yugabyte。
執行下方提供的步驟來建立 DSN 項目,或打算使用直接連線之後,請前往新增資料庫連線主題,瞭解如何建立資料庫連線。
設定 DSN 式連線
若要建立 Oracle GoldenGate 處理作業的 DSN 連線,您必須先新增 Oracle GoldenGate for Yugabyte 部署的環境變數,然後建立 odbc.ini 檔案來儲存連線屬性。
-
登入「服務管理程式」Web 介面。
-
從左側導覽窗格中,按一下部署,然後選取 Yugabyte 的部署名稱。這會展開部署的各種設定值。
-
按一下組態,然後按一下環境變數旁邊的加號 ( +)。
-
在兩個可用欄位中提供下列資訊。對於環境變數值欄位,請確定其為
odbc.ini檔案的絕對路徑:環境變數名稱 =
ODBCINI環境變數值 =
/ogg/deployment/yugabyte/odbc.ini -
按一下送出以建立新變數,然後從建置窗格重新啟動建置,以讓變更生效。
-
在 Oracle GoldenGate 安裝的
deployment資料夾中,手動建立odbc.ini檔案,然後在此檔案中新增資料來源。
建立 DSN 檔案時,請使用下列最小設定值:
-
Data Source Name– Oracle GoldenGate 處理作業 (例如 Extract 或 Replicat) 將參照之來源或目標資料庫連線的使用者定義名稱。DSN 名稱的長度最多允許 32 個英數字元,而且只能包含特殊字元的底線 (_) 和破折號 (-)。 -
IANAAppCodePage=4– 為預設設定,但當資料庫字元集不是 Unicode 時,可以根據 https://docs.progress.com/bundle/datadirect-connect-odbc-71/page/IANAAppCodePage_9.html#IANAAppCodePage_9 頁面上指定的指示來修改。 -
InstallDir– 是 Oracle GoldenGate PostgreSQL 線路協定驅動程式路徑的名稱,可以使用相對路徑,例如:InstallDir =./datadirect -
Driver:Oracle GoldenGate PostgreSQL 電線通訊協定驅動程式檔案的名稱,可以使用相對路徑,例如:Driver=./datadirect/lib/ggpsql25.so。 -
Database:這是來源或目標資料庫的名稱。 -
Hostname:這是資料庫主機 IP 位址或主機名稱。 -
PortNumber:這是資料庫的監聽連接埠。 -
Oracle GoldenGate for Yugabyte 支援多個主機和連接埠的 Yugabyte 連線。此功能在 Oracle GoldenGate 高可用性 (HA) 設定中很有用。在 Yugabyte HA 設定中,有一個主要和多個待命伺服器。您可以設定連線字串格式來指定多個主機:
連線字串 說明 db-user@host1,host2,host3/db-name將嘗試使用所有主機 ( host1、host2、host3) 的預設 Yugabyte 資料庫連接埠 5433 來連線。db-user@host1:1234,host2:2345,host3:3456/db-name系統將嘗試使用連線字串中指定之每個主機的相關連接埠來連線。 db-user@host1,host2,host3:1234/db-name所有主機上使用相同連接埠號碼 (1234) 的所有主機 ( host1、host2、host3)。將嘗試使用所有主機 (host1、host2、host3) 的連接埠 1234 來連線。db-user@host1,host2,host3:1234/db-name所有主機上使用相同連接埠號碼 (1234) 的所有主機 ( host1、host2、host3)。將嘗試使用所有主機的連接埠 1234 來連線。db-user@host1:3456,host2,host3:1234/db-name如果以其他格式指定連線字串,而指定其他主機時未指定任何連接埠,則會使用最後一個或最右邊的連接埠設定,作為連線字串中未指定連接埠號碼之所有主機的連接埠號碼。如連線字串所示:
db-user@host1:3456,host2,host3:1234/db-namehost2的連接埠號碼是 1234,這是連線字串中指定的最右邊連接埠號碼。 -
您也可以為 Extract 或 Replicat 使用者提供
LogonID和Password,但會以純文字儲存這些內容。建議將這些欄位保留在 DSN 中,而不是將它們儲存在 Oracle GoldenGate 公事包中作為證明資料別名,然後使用 Extract 和 Replicat 中的USERIDALIAS參數參照這些欄位。
以下為含有兩個 DSN 項目的 odbc.ini 檔案範例。以下範例中使用的資料來源名稱是 PG_src 和 PG_tgt。
|
|
| — |
|
-
儲存並關閉
odbc.ini檔案。 -
若要設定 Oracle GoldenGate 的 Yugabyte 部署資料庫連線,請參閱新增資料庫連線。