維護您的 OCI GoldenGate 部署

瞭解 GoldenGate 版本、如何及何時升級、接收或延遲通知，以及如何倒回升級。

關於 GoldenGate 版本

OCI GoldenGate 支援多個並行版本，例如 Oracle GoldenGate、Oracle GoldenGate for Big Data 和 Oracle GoldenGate for MySQL，以命名少數版本。如需您適用的版本明細，請參考版本參考。

每個版本都有建置版本號碼。有三種類型的版本：

主要：組建編號中的第一個數字代表主要版本。範例： 21。
組合銷售：第二個數字表示組合銷售核發。搭售品版本是一組主要發行版本的錯誤修正。範例： 21。5
次要：尾端數字代表次要版本。次要版本是由搭售品版本的一或多個錯誤修正所組成。範例： 21.5。0.0.0。

注意：所有版本類型都可以包含安全性修正。

視版本類型以及是否包含安全性修正而定，當有新版本可用時，您有特定的時間可以升級部署：

版次類型	主要	Bundle	次要
非安全性修正	365 天	180 天	不適用
安全修正	不適用	14 天	14 天

如果您未在指定的時間範圍內手動升級，則您的部署會在此時間範圍內結束時自動升級至最新版本。

注意：您可以在「升級」建置畫面和「升級」清單中檢視版本支援的日期。

不再使用版本

GoldenGate 版本自發行日期起至不再使用的日期為止。版本不再使用時，您無法再選取該版本來建立或升級部署。

不再使用期間使用與版本升級相同的時間範圍。舉例而言：

在主要版本發行後 365 天，舊版「主要」已不再使用。
搭售品版本發布後 180 天，相同主要版本的先前搭售品版本已棄用。
在 Security 修正發行版本 (搭售品或次要發行版本) 後 14 天，相同主要發行版本的所有先前版本都已不再使用。

注意：從 2027 年 4 月開始，所有 21 c 資料複製部署都會自動升級至最新的可用發行版本。區域之間的發行日期可能不同。

排定更新

您可以自訂定義何時升級部署的維護時段。如果您未定義維護時段，OCI GoldenGate 會根據最新版本的發行日期計算升級部署的最佳時間，然後在最接近自動升級期間計算結束的週末自動升級您的部署。

注意：發行新版的 Major、Bundle 或 Minor 版本時，OCI GoldenGate 會根據適用的時間表為您排定升級 (365 天 Major、180 天為 Bundle，14 天為 Minor 加上安全性修正)。如果相同版次的較新版本可供使用，則服務會使用可用的最新版本來升級您的部署，但排定的日期會維持不變。

您可以在建立部署或編輯現有部署時，自訂 OCI GoldenGate 維護時段。當新的 GoldenGate 版本可供使用時，部署會在所選的確切日期和時間自動升級。不過，當您選擇的手動升級升級升級時間落在維護時段之外時，部署可能會在您選擇的日期與時間之前自動升級。

例如，假設在 1 月 1 日，您還剩下 30 天來升級部署，直到 1 月 31 日星期二手動升級為止。不過，您的自訂維護時段則是從星期日的下午 10 點開始。透過此維護時段，OCI GoldenGate 將會在接下來的星期日下午 10 點升級您的部署，因為 OCI GoldenGate 一律會優先設定您的自訂時段。

若要編輯自訂維護時段，請執行下列動作：

在建置詳細資訊頁面的「建置」資訊區域之 GoldenGate 下，選取編輯來進行維護。
在「編輯維護參數」對話方塊中：
1. (選用) 選取自訂維護時段，以變更下列欄位的預設值。
2. 針對主要核發自動升級期間 (以天數計) ，輸入介於 0 與 365 之間的值。
3. 針對搭售品核發自動升級期間 (以天數計) ，輸入介於 0 與 180 之間的值。
4. 在安全路徑自動升級期間 (天) 中，輸入介於 0 與 14 之間的值。
5. (選用) 選取啟用次要版本自動升級，然後輸入次要版本自動升級期間 (天) 的值。
選取儲存變更。

升級之前

升級部署之前，請確認您已完成下列任務，並檢查長期執行的異動。

確定「存檔日誌」可供復原

使用「管理從屬端」中的下列命令，決定 Extract 啟動時可能需要回復的最舊存檔日誌。Recovery Checkpoint 欄位顯示復原所需的最舊日誌。

Admin Client > INFO EXTRACT group_name, SHOWCH

最好能在尖峰時間以外執行升級活動。如果有大量且長時間執行的交易，您可能會認為在來源系統上，新的 Extract 可能需要從一般復原檢查點開始處理，而不是超過繫結的復原檢查點，如果您停止 Extract 時最早開啟之交易的第一個記錄位於不在系統上的日誌中。

清除長期執行交易

若要清除長時間執行的交易，您有兩個選項：

您可以將存檔回復成復原檢查點中顯示的存檔，包括：
```
Admin Client > INFO EXTRACT
```
(如果來源資料庫支援此功能。)
您可以清除套用至您要升級之 Extract 的長時間執行交易。若要這樣做，可以略過交易，或將交易強制成為已確認交易的歷程檔。略過交易可能會導致資料遺失，如果倒回交易，將交易強制至歷程檔可能會在歷程檔中新增不需要的資料。若要略過或強制交易，請執行下列動作：
1. 檢視未結交易：
```
Admin Client > SEND EXTRACT group_name, SHOWTRANS
```
2. 記錄任何您要清除之異動的異動 ID。
3. 使用 SEND EXTRACT 和 SKIPTRANS 選項來清除舊交易以略過交易，或使用 FORCETRANS 強制交易處於其目前狀態至「歷程檔」作為已確認交易。舉例而言：
```
Admin Client > SEND EXTRACT group_name, {SKIPTRANS | FORCETRANS transaction_ID [THREAD n] [FORCE]}
```
4. 在您完成清除長時間執行的交易之後，請強制執行「限制的復原」檢查點。
```
Admin Client> SEND EXTRACT group_name, BR BRCHECKPOINT IMMEDIATE
```

同步 Replicat

對於具有平行 Replicat 的部署，請在升級前先確認同步 Replicat：

Admin Client > SYNCHRONIZE REPLICAT group_name

如需詳細資訊，請參閱 SYNCHRONIZE REPLICAT 指令行介面參照。

升級部署

請確定先完成升級前步驟。

升級部署時，

會停止部署, 然後在升級完成後重新啟動.
會停止所有 Oracle GoldenGate 處理作業, 然後再重新啟動 (若設定為自動啟動的話).

若要升級部署，請執行下列動作：

在「部署」頁面上，選取要升級的部署。
在部署詳細資料頁面上，從動作功能表中選取升級。
在升級部署面板中，選取要升級至的可用 GoldenGate 版本，然後選取升級。

注意：進一步瞭解版本。

升級需要幾分鐘的時間才能完成。在升級完成後，在部署詳細資料頁面上選取升級，以檢視升級歷史記錄，或在升級處理期間發生問題。

升級活動訊號表格

如果您的部署中使用活動訊號表格，您也必須升級活動訊號表格。完成升級之後，您可以：

執行「管理從屬端」中的 UPGRADE HEARTBEATTABLE 命令，為表格和延遲視觀表新增額外的資料欄。GoldenGate 使用這些額外的資料欄來追蹤 Extract 重新啟動位置。深入瞭解。
在建置主控台中，開啟「管理」主控台的導覽功能表，然後選取「組態」。連線至該資料庫。「活動訊號」表格出現時，請從「動作」功能表中選取「升級」。

升級通知

OCI GoldenGate 會在有升級可用時和排定升級時傳送事件通知給您。請參閱 GoldenGate 升級事件類型以瞭解詳細資訊，或進一步瞭解事件。

升級時間	小於 180 天	少於 30 天	7 天以下
通知期間	每 30 天	每 7 天	每天

注意： OCI GoldenGate 每天會傳送安全修正通知。

您也可以從出現在建置詳細資訊頁面上的通知橫幅瞭解即將進行的升級。

稍後通知

您可以延遲或延遲事件與橫幅通知。延後處理期間會隨著您更接近手動升級的時間範圍結束而變更。

升級時間	小於 180 天	少於 30 天	7 天以下
延遲期間	30 天	7 天	不允許

注意：不允許延後處理次要或搭售品升級的安全性修正。

您可以隨時取消延遲動作。

倒回升級

您可以將建置版本倒回至先前的建置版本。只允許倒回最新成功升級至其先前版本。

注意：在倒回期間，部署檔案系統會在升級前回復為最後狀態。

舊版已不再使用時，不允許回復。

若要倒回升級：

從「部署」頁面中，選取要倒回的部署。
在部署詳細資料頁面上，選取升級。
在「升級」清單中，尋找最新的先前版本，然後從其「動作」功能表中選取倒回。
選取要倒回的版本，然後選取倒回。

備註：請參考版本參考以取得可用版本清單。

您的部署狀態會變更為更新，需要幾分鐘的時間才能完成。

重新排定升級

您可以重新排定自動排定的升級。您可以將升級重新排定為更接近的日期，或將升級延後至較晚的日期。

備註：重新排程不會將維護時段納入考量。您新排定的日期不可晚於 OCI GoldenGate 的定義值。如需詳細資訊，請參閱關於 GoldenGate 版本。

若要重新排定升級，請執行下列動作：

從「部署」頁面中，選取要重新排定其升級的部署。
在部署詳細資料頁面上，選取升級。
在「升級」清單中，尋找最新的先前版本，然後從其「動作」功能表中選取重新排定。
在「重新排定」部署升級視窗中，選取執行升級的日期和時間。
選取儲存變更。

在「升級」清單中，「排程」的日期與時間會反映變更。

取消更新

只有當目標版本為次要版次時，您才能取消自動排定的升級。

注意：取消升級至次要版次將不會隱含地停用次要版次的自動升級，而且必須手動停用。您可以從部署詳細資訊頁面停用次要版本自動升級。請參閱排程升級以瞭解詳細資訊。

若要取消升級，請執行下列動作：

從「部署」頁面中，選取要取消其升級的部署。
在部署詳細資料頁面上，選取升級。
在「升級」清單中，尋找最新的先前版本，然後從其「動作」功能表中選取取消。
在「取消部署升級」視窗中，選取取消部署升級。

升級的狀態會更新為「已取消」。

已知問題

升級至 Oracle GoldenGate 23.26.x 後，部署主控台 502 有錯誤的閘道錯誤，或登入後無法列出 GoldenGate 處理作業

從舊版標籤升級至 23.26.x 版本，或在 23.26.x 部署上執行停止 / 啟動作業之後，Oracle Cloud Infrastructure GoldenGate 23.26 部署可能會變得狀況不佳。

解決方法：將受影響的 Oracle 部署升級為 oggoracle:23.26.1.0.0_260331 標籤，以修正此問題。

針對大數據和其他非 Oracle 標籤，我們將盡快發布修正。請聯絡支援中心以取得臨時手動緩解措施，以防止影響。

從 21.15 或 23.x 組建倒回至 21.14 時發生問題

嘗試將 21.15 或 23.x 組建倒回至下列其中一個組建時：

Oracle (21.14.0.0.0_240525)
大數據 (21.14.0.0.0_240515)
MySQL (21.14.0.0.0_240404)
MSSQL (21.14.0.0.0_240404)

您可能會遇到下列其中一個問題：

新的公事包加密功能自 21.15 起引進，因此遺漏連線 / 證明資料問題。

解決方法：您必須將現有連線取消指定並重新指定給部署，並重新建立任何使用中的「分配」或「接收者」路徑所需的遺漏使用者。
「服務管理程式」無法啟動，因為從 23.x 倒回至 21.14 的「效能度量服務」發生問題。如果您遇到此問題，請聯絡 Oracle Support。
Oracle GoldenGate 處理作業失敗，錯誤為「OGG-02431 checkpoint 檔案中找到無效的記錄標頭 .」

解決方法：將部署升級至系列中最新的 21.14 組建。如果持續發生問題，請聯絡 Oracle Support。