新增 MySQL 擷取

Extract 是針對來源資料來源連線和擷取或擷取資料執行的處理作業。瞭解如何新增 Extract for MySQL Database Server、OCI 上的 HeatWave、Azure Database for MySQL、AWS 上的 HeatWave、Amazon Aurora MySQL、Amazon RDS for MySQL、Amazon RDS for MariaDB、MySQL 的 Google Cloud SQL、SingleStoreDB、SingleStoreDB Cloud、AWS 上的 HeatWave 以及 Azure 技術上的 HeatWave。

新增擷取 (26ai)

新增和執行 Extract 之前，請確定您準備 Oracle GoldenGate 26ai 的資料庫。

若要在 Oracle GoldenGate 26ai 中新增 MySQL 來源的 Extract，請執行下列動作：

在 OCI GoldenGate 部署主控台導覽功能表中，選取擷取。
在「摘錄」頁面上，選取新增摘錄 (加號)。
「新增摘錄」表單由四個頁面組成。視需要完成「新增摘錄」表單：
1. 在「擷取資訊」頁面上：
  1. 選取擷取類型：
    - 變更資料擷取 Extract
    - 起始載入 Extract
  2. 輸入程序名稱。
  3. (選用) 輸入說明。
  4. 選取下一步。
2. 在「擷取選項」頁面上：
  1. 選取開始的時間：
    - Now
    - 自訂時間
    - 日誌中的位置
    - 日誌結尾
  2. 輸入擷取歷程檔詳細資訊：
    - 名稱 (只能有兩個字元。)
    - 子目錄
    - 歷程檔大小
    - 軌跡序號
    - 軌跡偏移量
  3. 從下拉式清單中選取「來源證明資料」網域和別名。
  4. 選取下一步。
3. 在「受管理選項」頁面上，視需要完成選擇性欄位，然後選取下一步：
- 設定檔名稱
- 對於部署狀況具有重大影響
- 自動啟動
- 自動重新啟動
  
  注意：新增設定檔並設定「自動啟動」和「自動重新啟動」選項，可讓您的部署在網路中斷後自動重新啟動。請參閱設定受管理處理作業以瞭解詳細資訊。
1. 在「參數檔」頁面上，可以編輯文字區中的參數檔，列出要擷取的表格詳細資訊。舉例而言：
```
table source.table1;
```
  注意：
  
  依照預設，GoldenGate 使用格林威治標準時間 (GMT)。使用 SETENV 來置換 Extract 的預設設定。此變更僅適用於「擷取」處理，不適用於部署。
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
選取建立並執行以開始擷取。如果您選取「建立」，您可以稍後從「摘錄」頁面手動啟動「摘錄」。

您可返回「摘錄」頁面，在此您可以選取「摘錄」處理程序以檢視其詳細資料。

新增擷取 (21c)

新增及執行 Extract 之前，請確定您準備並設定 Oracle GoldenGate 系統。

若要在 Oracle GoldenGate 21 c 中新增 MySQL 資料庫的擷取，請執行下列動作：

在 OCI GoldenGate 部署主控台中，確定您位於「管理服務總覽」頁面，然後選取新增擷取 (加上圖示)。
在「新增擷取」頁面上，針對擷取類型選取下列其中一項，然後選取下一步。
- 變更資料擷取
- 起始載入
在「擷取選項」頁面的「基本資訊」下，視需要完成欄位：
1. 在處理名稱中，輸入「擷取」處理的名稱，最多 8 個字元。
2. (選用) 在描述中，輸入簡短描述以協助您區分此程序與其他程序。
3. 對於目的，請選取最能描述此「擷取」用途的選項：
  - 單向 (預設)
  - 災害復原
  - N 向
4. 只有在從不使用全域交易識別碼 (GTID) 的 MySQL 資料庫擷取資料時，才啟用遠端。
5. 在證明資料網域中，選取 Oracle GoldenGate 。
6. 針對證明資料別名，選取您的來源 MySQL 連線。
7. 在歷程檔名稱中，輸入「歷程檔」檔案的兩個字元名稱。
8. (選用) 在歷程檔子目錄中，為產生的歷程檔設定自訂位置。
9. (選用) 若為歷程檔大小，請設定所產生歷程檔的大小上限。
(可選擇) 在「加密設定檔」下，輸入加密設定檔描述。如果未建立加密設定檔，預設會選取本機公事包設定檔。
1. 從下拉式清單中選取設定檔名稱。您可以選取「本機公事包」或自訂設定檔。
2. 從下拉式清單中選取加密設定檔。
3. 指定加密設定檔的主要金鑰。
(選擇性) 在「受管理的選項」下，您可以設定下列項目：
- 設定檔名稱
- 自動啟動
- 自動重新啟動
  
  注意：新增設定檔並設定「自動啟動」和「自動重新啟動」選項，可讓您的部署在網路中斷後自動重新啟動。請參閱設定受管理處理作業以瞭解詳細資訊。
選取下一步。
在「擷取參數」頁面上，您可以編輯文字區中的參數檔，以列出要擷取的表格詳細資訊。舉例而言：
```
table source.table1;
```
注意：

依照預設，GoldenGate 使用格林威治標準時間 (GMT)。使用 SETENV 來置換 Extract 的預設設定。此變更僅適用於「擷取」處理，不適用於部署。
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
進一步瞭解 SETENV 。
選取在背景中註冊擷取，以非同步方式在背景中註冊 Extract。
選取建立並執行以建立並啟動 Extract。如果您選取建立，則可以稍後從「管理服務總覽」頁面手動啟動 Extract。

您會返回「管理服務概要」頁面，您可在此頁面檢視「擷取」處理程序的狀態。從「擷取動作」功能表中選取詳細資訊，以檢視處理作業資訊、檢查點、統計資料、參數以及報表。

深入瞭解

想要深入瞭解 Extract 處理作業和擷取資料嗎？請參閱：

將資料從 MySQL 複寫至 Autonomous AI Lakehouse

已知問題

啟用 GTID 之資料庫的遠端變更資料擷取擷取失敗

當您針對使用全域異動 ID (GTID) 的 MySQL 資料庫啟用「遠端」選項來建立「變更資料擷取擷取」處理程序時，「擷取」處理程序會失敗，並報告下列錯誤：

ERROR   OGG-25192  Trail file '<trail name>' is remote. Only local trail allowed for this extract.

解決方法：在「變更資料擷取擷取」的「參數」檔案畫面上，移除行 TRANLOGOPTIONS ALTLOGDEST REMOTE。

如需詳細資訊，請參閱使用 Oracle GoldenGate for MySQL 。