管理歷程檔

OCI GoldenGate 歷程檔會隨著時間快速增加。如果沒有管理這些歷程檔的永久清除作業,每日備份將需要花費較長的時間來完成,並使用其他地方可使用的運算資源。

附註:

此資訊僅適用於資料複製部署。

相關主題

檢視歷程檔

您可以在部署詳細資訊頁面上檢視歷程檔詳細資訊,例如大小、順序、產生者和用戶。

若要檢視歷程檔,請執行下列動作:
  1. 在 GoldenGate 總覽頁面中,按一下部署
  2. 在「部署」頁面上,選取部署以檢視其詳細資料,或從部署的「動作」功能表中選取檢視詳細資料
  3. 在「建置詳細資訊」頁面上,按一下歷程檔

您可以使用此資訊來識別不再使用或不需要的歷程檔,然後建立「整個清除」工作來進行管理。

加密歷程檔

您可以使用部署主控台中的加密設定檔或建立主要加密金鑰公事包,來加密歷程檔。本主題涵蓋具有和不含資源主要項目的加密設定檔。如需主要加密金鑰公事包的相關資訊,請參閱管理加密金鑰公事包

在您繼續之前,請確定您具有:

以資源主體加密

資源主體是身分識別與存取管理 (IAM) 的一項功能,可授權資源作為對資源執行動作的主要動作者。每個資源都有自己的識別,而資源則使用新增至該資源的憑證進行認證。這些憑證會自動建立、指定給資源及輪換,讓您不需要建立及管理自己的證明資料即可存取資源。

您可以使用資源主體來存取您的保存庫金鑰,然後用來加密歷程檔。若要這樣做,您的部署必須能夠存取您選取的金鑰保存庫金鑰。確定您已複查加密歷程檔中所列的需求,特別是保存庫服務的最低必要原則

若要使用資源主體加密歷程檔,請執行下列動作:
  1. 在部署詳細資料頁面上,按一下啟動主控台
  2. 在部署主控台的導覽功能表中,展開加密,然後選取設定檔
  3. 對於「Oracle Cloud Infratstructure with Resource Principal 」,按一下「新增外掛程式加密設定檔」。
  4. 在「建立加密設定檔」面板中,完成下列欄位:
    1. 設定檔名稱中,輸入此加密設定檔的名稱。
    2. (選用) 新增描述。
    3. 貼上您 OCI 保存庫的 OCI 保存庫金鑰 OCID 。您可以在 Vault 的「加密金鑰」詳細資訊頁面中找到此資訊。
    4. 請從您的保存庫詳細資訊頁面輸入 OCI 保存庫的加密端點
  5. 按一下提交

不使用資源主體加密

在不使用資源主體的情況下加密歷程檔:
  1. 在部署詳細資料頁面上,按一下啟動主控台
  2. 在部署主控台的導覽功能表中,展開加密,然後選取設定檔
  3. 若為 Oracle Cloud Infratstructure ,請按一下新增外掛程式加密設定檔
  4. 在「建立加密設定檔」面板中,完成下列欄位:
    1. 輸入設定檔名稱
    2. 輸入說明
    3. 貼到加密端點 URL 中,您可以在保存庫詳細資訊頁面找到此 URL.
    4. 貼到您的租用戶 OCID 中,您可以在「租用戶詳細資訊」頁面找到此資訊。
    5. 貼到您的金鑰 OCID 中,您可以在「金鑰詳細資訊」頁面找到。
    6. 貼到您的使用者 OCID 中,您可以在使用者設定檔頁面找到。
    7. 上傳或貼上 API 金鑰,您可以從使用者設定檔頁面的記號和金鑰區段產生此金鑰。
    8. 貼到與您的 API 金鑰關聯的金鑰指紋中。
  5. 按一下提交

永久清除歷程檔

OCI GoldenGate 歷程檔會隨著時間快速增加。如果沒有永久清除管理這些歷程檔的作業,每日備份將花費更長的時間來完成,並使用可在其他地方使用的運算資源。

Oracle 建議您先建立備份,再清除歷程檔。請參閱建立手動備份。接著,您可以下載備份並複查其內容 (<deployment-name>/var/lib/data/)。
若要清除 OCI GoldenGate 歷程檔,請執行下列動作:
  1. OCI GoldenGate 部署主控台中,複查下列產生「歷程檔」檔案的處理作業,並記下要保留的歷程檔:
    • 在「管理服務」中,複查每個 Extract 和 Replicat 的詳細資訊。(按一下程序名稱,然後選取詳細資訊。)
    • 在配銷服務中,檢閱每個配銷路徑的詳細資訊 (如果有的話)。
    • 在「接收端服務」中,複查每個「接收端路徑」(如果有的話) 的詳細資訊。

    所有不在清單中的其他歷程檔都可以永久清除。

  2. 設定清除任務以清除部署主控台中未使用的歷程檔。
    1. OCI GoldenGate 建置主控台中,開啟「管理服務」的導覽功能表 (漢堡圖示),然後選取組態
    2. 在「組態」頁上,按一下「工作」,然後按一下「整個清除歷程檔」。
    3. 按一下新增整個清除歷程檔工作 (加上圖示)。
    4. 在建立新的「整個清除歷程檔」工作下,完成下列欄位,然後按一下送出
      1. 作業名稱中,輸入永久刪除作業的名稱。
      2. 針對歷程檔,輸入歷程檔的名稱,然後按一下新增歷程檔 (加號圖示)。重複此步驟以新增其他歷程檔。選取的歷程檔會在您新增歷程檔時填入歷程檔的名稱。
      3. 如果您想要在所有 Extract 和 Replicat 處理作業以檔案完成後 (如檢查點所示) 永久清除,請維持啟用使用檢查點。停用此選項可在不考慮檢查點和至少一個檔案 (如果未指定 MIN 值) 的情況下永久清除,或保留以 MIN 指定的檔案數目。

        附註:

        無法在部署主控台中刪除獨立檢查點檔案。使用 REST API 刪除獨立的檢查點檔案。
      4. 針對保留規則,指定要保留的「時數」、「天數」或「檔案數目」。
      5. 若為永久清除頻率,請指定執行此永久清除工作的頻率。

    您可以視需要新增更多「清除任務」或停用這些任務。

  3. 使用管理用戶端清除未使用的歷程檔。
    1. 在部署詳細資料頁面上,按一下啟動管理用戶端
      如果使用專用端點連線至 OCI GoldenGate 部署,請依照透過 Cloud Shell 連線至管理從屬端中的指示進行。
    2. 執行下列命令來永久清除 Extract 已不再使用的歷程檔:
      purge exttrail <trail-file-name>
      如需詳細資訊,請參閱 GoldenGate Command Line Reference 手冊中的 PURGE EXTTRAIL
  4. 使用 REST API 清除未使用的歷程檔。
    1. 開啟 Cloud Shell。
    2. 在 Cloud Shell 中,對 OCI GoldenGate 部署執行下列 REST API 呼叫。請確定您以部署的實際值取代預留位置。
      curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type:
            application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ {
            "name": "<trail_file_name>" } ], "useCheckpoints": false, "keep": [ { "type":
            "min", "units": "files", "value": 0 } ]}'

若要確保刪除所有歷程檔,您可以執行下列其中一項作業:

  • 在 Oracle Cloud 主控台的部署詳細資料頁面上,選取歷程檔,然後按一下重新整理以複查歷程檔清單。
  • 建立另一個手動備份,並檢查備份的內容,以尋找要保留的 Trail 檔案。請注意備份現在完成的彙總大小縮減與速度。

REST 範例

下列範例顯示如何在不同條件下移除歷程檔:

範例 1:整個清除名稱符合 "IL" 的所有歷程檔:

curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ { "name": "IL" } ], "useCheckpoints": false, "keep": [ { "type": "min", "units": "files", "value": 0 } ]}'

範例 2:清除子目錄 demo 中星號 (*) 所指示的所有歷程檔:

curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ { "name": "*", "path": "/u02/Deployment/var/lib/data/demo" } ], "useCheckpoints": false, "keep": [ { "type": "min", "units": "files", "value": 0 } ]}'

範例 3:清除所有 L1 擷取歷程檔:

curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ { "name": "L1" } ], "useCheckpoints": false, "keep": [ { "type": "min", "units": "files", "value": 0 } ]}'

範例 4:清除名稱符合 "L1" 但保留過去 10 小時之檔案的所有歷程檔:

curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ { "name": "L1" } ], "useCheckpoints": false, "keep": [ { "type": "min", "units": "hours", "value": 10 } ]}'

範例 5:使用 USECHECKPOINTS 清除超過一天的所有 L1 擷取歷程檔:

curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ { "name": "L1" } ], "useCheckpoints": true, "keep": [ { "type": "min", "units": "days", "value": 1 } ]}'

範例 6:清除超過一天的所有 L1 擷取歷程檔:

curl -X POST https://<domain-name>/services/v2/commands/execute -n -H 'Content-Type: application/json' -d '{ "name": "purge", "purgeType": "trails", "trails": [ { "name": "L1" } ], "useCheckpoints": false, "keep": [ { "type": "min", "units": "hours", "value": 23 } ]}'