將資料從 YugabyteDB 複寫至 Autonomous AI 交易處理

瞭解如何使用 OCI GoldenGate 將資料從 YugabyteDB 來源複製到 Autonomous AI Transaction Processing 目標。

開始之前

若要順利完成此快速啟動,請確定您具備:

設定 YugabyteDB

若要設定您的 YugabyteDB 執行處理:
  1. 如果使用 Oracle Cloud Compute 代管 YugabyteDB ,請開啟連接埠 5433:
    sudo firewall-cmd --permanent --add-port=5432/tcp
    sudo firewall-cmd --reload 
    sudo firewall-cmd --list-all 
  2. 在 VCN 的安全清單中開啟連接埠 5433。
  3. 連線到 YugabyteDB
  4. 下載範例資料
  5. 執行下列命令以設定使用者。請確定以實際的密碼取代 <password> 預留位置。
    create user ggadmin with password '<password>'; 
    alter user ggadmin with SUPERUSER; 
    GRANT ALL PRIVILEGES ON DATABASE ociggll TO ggadmin; 

環境設定:自治式 AI 交易處理 (ATP)

  1. 下載並解壓縮範例資料庫綱要
  2. 解除鎖定 GGADMIN 使用者。
    1. 在 Oracle Cloud 主控台中,從自治式 AI 資料庫頁面選取您的可承諾量執行處理,以檢視其詳細資訊並存取資料庫動作。
    2. 按一下資料庫動作,然後按一下資料庫使用者
    3. 找到 GGADMIN ,然後按一下其省略符號功能表 (三個點),並選取編輯
    4. 在「編輯使用者」面板中,輸入 GGADMIN 密碼,確認密碼,然後取消選取帳戶已鎖定
    5. 按一下套用變更
  3. 載入目標範例綱要和資料。
    1. 從「資料庫動作 (Database Actions)」功能表選取 SQL
    2. OCIGGLL_OCIGGS_SETUP_USERS_ADW.sql 複製命令檔並貼到 SQL 工作表中。
    3. 按一下執行指令碼。「命令檔輸出」頁籤會顯示確認訊息。
    4. 清除 SQL 工作表,然後從 OCIGGLL_OCIGGS_SRC_MIRROR_USER_SEED_DATA.sql 複製並貼上 SQL。
    5. 如果要確認表格已順利建立,請關閉 SQL 視窗再重新開啟。在「導覽器 (Navigator)」頁籤中,尋找 SRC_OCIGGLL 綱要,然後從它們各自的下拉式清單中選取表格。

工作 1:建立 OCI GoldenGate 資源

此快速啟動範例需要來源和目標的部署和連線。
  1. 建立部署來源 PostgreSQL 資料庫。
  2. 建立部署目標 Autonomous AI Transaction Processing 執行處理。
  3. 建立來源 PostgreSQL 資料庫連線
    1. 若為類型,請確定選取 YugabyteDB
    2. 對於資料庫名稱,請輸入 YugabyteDB 名稱。
    3. 主機中,輸入執行 YugabyteDB 之運算執行處理的公用 IP。
    4. 對於連接埠,請輸入 5433
    5. 使用者名稱中,輸入 ggadmin
    6. 密碼中,輸入密碼。
    7. 在「安全協定」中,選擇「純文字」。
  4. 建立「 Autonomous AI Transaction Processing 」目標執行處理的連線
  5. 建立 GoldenGate 連線,然後將此連線指派給來源 PostgreSQL 部署
  6. 指定來源 PostgreSQL 部署的來源連線
  7. 將目標連線指派給目標 Oracle 部署

任務 2:啟用補充記錄

若要啟用補充日誌記錄:
  1. 啟動 PostgreSQL GoldenGate 部署主控台:
    1. 從「部署」頁面中,選取 PostgreSQL 部署以檢視其詳細資訊。
    2. 在 PostgreSQL 部署詳細資訊頁面上,按一下啟動主控台
    3. 在建置主控台登入頁面中,輸入先前建立建置時所提供的 GoldenGate 管理員證明資料。

      附註:

      建立部署時若未選取 IAM 作為證明資料存放區,則必須登入。
  2. 在 GoldenGate 26ai 中,依序按一下左側導覽中的資料庫連線、來源 YugabyteDB 資料庫,然後按一下 Trandata
  3. 在「TRANDATA」頁面的「TRANDATA 資訊」旁邊,按一下新增 TRANDATA (加號圖示)。
  4. 在 Trandata 面板中,對於結構名稱,輸入 src_ociggll.*,然後按一下提交

    附註:

    使用搜尋欄位來搜尋 src_ociggll,並驗證已新增表格。

任務 3:建立擷取

  1. 新增 Change Data Capture Extract
    1. 在左側導覽中,按一下擷取
    2. 在「擷取」頁上,按一下「新增擷取」(加號圖示),然後依照下列方式完成欄位:
      • 在「擷取資訊」頁面上:
        1. 對於擷取類型,請選取變更資料擷取擷取
        2. 針對程序名稱,輸入擷取的名稱,例如 ECDC
        3. 按一下下一步
      • 擷取選項頁面上:
        1. 若為「來源」證明資料,請從網域下拉式清單中選取 Oracle GoldenGate
        2. 別名下拉式清單中選取來源 PostgreSQL 資料庫。
        3. 對於擷取歷程檔名稱,請輸入兩個字元的歷程檔名稱,例如 C1
        4. 按一下下一步
      • 擷取參數頁面中,以下列項目取代 MAP *.*, TARGET *.*;
        TABLE SRC_OCIGGLL.*;
    3. 按一下「建立並執行」。
  2. 新增初始載入擷取
    1. 在「擷取」頁面上,按一下新增擷取,然後完成「新增擷取」表單,如下所示:
      • 擷取資訊頁面上:
        1. 對於擷取類型,請選取起始載入擷取
        2. 程序名稱中,輸入名稱,例如 EIL
        3. 按一下下一步
      • 擷取選項頁面上:
        1. 若為「來源」證明資料,請從網域下拉式清單中選取 Oracle GoldenGate
        2. 別名下拉式清單中選取 YugabyteDB
        3. 擷取歷程檔名稱中輸入兩個字元的歷程檔名稱,例如 I1
        4. 按一下下一步
      • 擷取參數頁面上,使用下列項目取代文字區域的內容:
        EXTRACT EIL
        USERIDALIAS YugabyteDB_Compute, DOMAIN OracleGoldenGate
        EXTFILE I1, PURGE
        TABLE src_ociggll.*;

        附註:

        請確定先移除 USERIDALIAS 前面的 SOURCEDB 參數,再繼續進行。
    2. 按一下「建立並執行」。
您可以返回擷取頁面,在此您可以從擷取開始觀察。

工作 4:建立 Initial Load 擷取Distribution Path

  1. 在「建置」頁面上,選取目標 Oracle 建置。
  2. 在部署詳細資料頁面上,按一下啟動主控台,然後以管理員使用者身分登入。
  3. 如果使用 IAM 證明資料存放區,請繼續執行「建立 Distribution Path」步驟。如果使用 GoldenGate 證明資料存放區,請建立來源 GoldenGate 用來連線至目標 GoldenGate 的使用者。
    1. 在導覽功能表中,按一下使用者管理
    2. 按一下新增使用者 (加號圖示),完成欄位如下,然後按一下提交
      • 使用者名稱中,輸入 ggsnet
      • 角色中,選取運算子
      • 輸入密碼兩次以進行驗證。
  4. 來源 PostgreSQL 建置主控台中,為在上一個步驟中建立的使用者建立「路徑連線」。
    1. 在瀏覽功能表中,按一下路徑連線
    2. 按一下新增路徑連線 (加號圖示)、完成欄位,然後按一下送出
      • 在「證明資料別名」中輸入 dpuser
      • 對於使用者 ID,請輸入 ggsnet
      • 若為「密碼」,請輸入上一個步驟所使用的相同密碼。
  5. 建立 Distribution Path
    1. 在服務功能表列中,按一下 Distribution Service ,然後按一下新增 Distribution Path (加號圖示)。
    2. 完成「新增路徑」表單,如下所示:
      • 在「路徑資訊 (Path Information)」頁面上:
        1. 路徑名稱中,輸入此路徑的名稱。
        2. 按一下下一步
      • 在「來源選項 (Source Options)」頁面上:
        1. 對於來源 Extract ,請保留空白。
        2. 歷程檔名稱中,輸入 Initial Load Extract 歷程檔名稱 (I1)。
        3. 按一下下一步
      • 在「目標選項 (Target Options)」頁面上:
        1. 目標協定中,選取 wss
        2. 針對目標主機,輸入不含 https:// 或任何尾端斜線的目標部署 URL。
        3. 連接埠號碼中,輸入 443
        4. 歷程檔名稱中,輸入 I1
        5. 目標認證方法中,選取 OAuth

          附註:

          如果在建立部署時選取 GoldenGate 作為證明資料存放區,請選取 UserID 別名。否則,請選取 OAuth
        6. 網域中,輸入在上一個步驟中建立的網域名稱。
        7. 別名中,輸入在上一個步驟中建立的別名 (dpuser)。
        8. 按一下下一步
    3. 按一下「建立並執行」。
    您可以返回 Distribution Service 頁面,在此您可以複查建立的路徑。
  6. 在「目標 Oracle 建置主控台」中,複查因「分配」路徑而建立的「接收者」路徑:
    1. 按一下 Receiver Service
    2. 複查 Distribution Path 詳細資訊。

工作 5:新增 Initial LoadReplicat

  1. 目標 Oracle 建置中,新增 Checkpoint 表格。
    1. 在導覽功能表中,按一下 DB 連線
    2. 依序選取目標 Autonomous AI Database 執行處理和 Checkpoints
    3. Checkpoints 頁面上,按一下新增檢查點 (加號圖示)。
    4. Checkpoint 面板中,對於綱要表格,輸入 SRCMIRROR_OCIGGLL.CHECKTABLE
    5. 按一下提交
  2. 新增 Replicat
    1. 在導覽功能表中,按一下 Replicats
    2. Replicats 頁面上,按一下新增 Replicat (加號圖示),然後完成「新增 Replicat」欄位,如下所示:
      • Replicat 資訊頁面上:
        1. 對於 Replicat 類型,請選取 Nonintegrated Replicat
        2. 程序名稱中,輸入名稱,例如 RIL
        3. 按一下下一步
      • 在「Replicat 選項」頁面上:
        1. Replicat 歷程檔名稱中,輸入工作 2 (I1) 的歷程檔名稱。
        2. 若為目標證明資料,請選取網域別名以進行自治式 AI 資料庫連線。
        3. 針對檢查點表格,選取您在步驟 1 中建立的檢查點表格。
        4. 按一下下一步
      • 在「參數檔」頁面上,使用下列項目取代 MAP *.*, TARGET *.*;
        MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
    3. 按一下「建立並執行」。
      您可以返回 Replicats 頁面,您可以在此複查 Replicat 詳細資訊。
  3. 選取 Replicat ( RIL) 並檢視其詳細資訊
  4. 按一下統計資料 (Statistics) 並複查插入數目。重新整理頁面.
    • 如果「插入」數目未變更,則會載入 Initial Load 中的所有記錄,您可以停止 Replicat ( RIL)
    • 如果「插入」的數目持續增加,請繼續重新整理頁面,直到 Initial Load 記錄全部載入為止。
  5. 驗證 Initial Load
    1. Oracle Cloud 主控台自治式 AI 資料庫詳細資訊頁面中,依序按一下資料庫動作SQL
    2. 在 SQL 工具中,將下列每個敘述句輸入工作表,然後按一下執行敘述句
      SELECT * FROM SRCMIRROR_OCIGGLL.SRC_CITY;
      SELECT * FROM SRCMIRROR_OCIGGLL.SRC_CUSTOMER;
    輸出應傳回因 Initial Load 而載入至目標資料庫表格的資料。

工作 6:建立 Change Data Capture ExtractDistribution Path

  1. 在「來源 PostgreSQL 建置主控台」中,按一下 Distribution Service
  2. 按一下新增 Distribution Path
  3. 完成「新增路徑」表單,如下所示:
    1. 在「路徑資訊 (Path Information)」頁面上:
      1. 路徑名稱中,輸入名稱。
      2. 按一下下一步
    2. 在「來源選項 (Source Options)」頁面上:
      1. 對於來源 Extract ,請選取 Change Data Capture Extract (ECDC))。
      2. 對於歷程檔名稱,請選取 Change Data Capture 歷程檔 (C1)。
      3. 按一下下一步
    3. 在「目標選項 (Target Options)」頁面上:
      1. 目標中,選取 wss
      2. 目標主機中,輸入目標建置主控台 URL (您可以在建置詳細資訊頁面上找到此 URL,而不需要 https:// 或任何尾端斜線。
      3. 連接埠號碼中,輸入 443
      4. 歷程檔名稱中,輸入 C1
      5. 目標認證方法中,選取 OAuth

        附註:

        如果在建立部署時選取 GoldenGate 作為證明資料存放區,請選取 UserID 別名。否則,請選取 OAuth
      6. 針對網域,輸入網域的名稱。
      7. 別名輸入別名。
    4. 按一下建立路徑並執行
  4. 在目標 Oracle 部署主控台中,按一下接收者服務,然後複查建立的接收者路徑。

工作 7:新增 Change Data CaptureReplicat

  1. 在「目標 Oracle 建置主控台」中,新增 Replicat
    1. 在「管理服務」導覽功能表中,按一下 Replicats
    2. Replicats 頁面上,按一下「新增 Replicat」(加號圖示),然後完成「新增 Replicat」表單,如下所示:
      • 在 Replicat 資訊頁面上:
        1. 對於 Replicat 類型,請選取 Nonintegrated Replicat
        2. 針對處理名稱,輸入名稱,例如 RCDC
        3. 按一下下一步
      • 在「Replicat 選項」頁面上:
        1. Replicat 歷程檔名稱中,輸入任務 3 (C1) 的歷程檔名稱。
        2. 目標憑證中,選取自治式 AI 資料庫連線的網域和別名。
        3. 針對檢查點表格,選取「檢查點」表格。
      • Replicat 參數頁面中,以下列對應取代 MAP *.*, TARGET *.*;
        MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
    3. 按一下建立。請勿執行 Replicat
  2. Replicats 頁面上,為 Initial Load ( RIL) 選取 Replicat,並檢視其詳細資訊
  3. 按一下統計資料 (Statistics) 並複查插入數目。重新整理頁面.
    • 如果「插入」數目未變更,則會載入 Initial Load 中的所有記錄,您可以停止 Replicat (RIL)
    • 如果「插入」數目持續增加,請繼續重新整理頁面,直到 Initial Load 記錄全部載入為止。

    附註:

    如果您未見到任何「插入」,請按一下效能測量結果服務,選取擷取,然後按一下資料庫統計資料
  4. 返回 Replicats 頁面,然後啟動 Change Data Capture (RCDC) 的 Replicat
  5. 啟動 Change Data CaptureReplicat 之後,請複查其詳細資訊統計資料,以檢視插入的數目。
  6. 驗證複寫:
    1. 執行下列命令檔以執行 PostgreSQL 資料庫的插入:
      Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1000,'Houston',20,743113);
      Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1001,'Dallas',20,822416);
      Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1002,'San Francisco',21,157574);
      Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1003,'Los Angeles',21,743878);
      Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1004,'San Diego',21,840689);
      Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1005,'Chicago',23,616472);
      Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1006,'Memphis',23,580075);
      Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1007,'New York City',22,124434);
      Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1008,'Boston',22,275581);
      Insert into src_ociggll.src_city (CITY_ID,CITY,REGION_ID,POPULATION) values (1009,'Washington D.C.',22,688002);
    2. 在來源 PostgreSQL 建置主控台中,選取 Change Data Capture Extract (ECDC),然後按一下統計資料。確認 src_ociggll.src_city 有 10 個插入項目。

      附註:

      如果 Extract 未擷取任何插入,請重新啟動 ECDC Extract
    3. 在目標 Oracle 建置主控台中,選取 Replicat 名稱 (RCDC),檢視其詳細資訊,然後檢查統計資料。確認 SRCMIRROR_OCIGGLL.SRC_CITY 有 10 個插入。

工作 8:監督和維護處理作業

  1. 監督效能
  2. 管理歷程檔