管理歷程檔

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

注意：

此資訊僅適用於資料複製部署。
依照預設，每個資料複製部署會自動永久清除超過 21 天的歷程檔。

檢視歷程檔

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

若要檢視歷程檔，請執行下列動作：

從 GoldenGate 總覽頁面中，選取部署。
在「部署」頁面上，選取部署以檢視其詳細資料，或從部署的「動作」功能表中選取檢視詳細資料。
在「建置詳細資訊」頁面上，選取歷程檔。

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

加密歷程檔

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

開始之前

存取保存庫服務和已建立保存庫。

注意： 不需要虛擬專用保存庫。
已將最低必要原則新增至 OCI GoldenGate 以使用保存庫服務。

以資源主體加密

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

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

若要使用資源主體加密歷程檔，請執行下列動作：

在您的部署詳細資料頁面上，選取啟動主控台。
在部署主控台的導覽功能表中，展開加密，然後選取設定檔。
針對 Oracle Cloud Infrastructure 與資源委派人，選取新增外掛程式加密設定檔。
在「建立加密設定檔」面板中，完成下列欄位：
1. 在設定檔名稱中，輸入此加密設定檔的名稱。
2. (選用) 新增描述。
3. 貼上您 OCI 保存庫的 OCI 保存庫金鑰 OCID 。您可以在金鑰保存庫的「加密金鑰」詳細資訊頁面中找到此資訊。
4. 從您的保存庫詳細資訊頁面輸入 OCI 保存庫的加密端點。
選取提交。

不使用資源主體加密

在不使用資源主體的情況下加密歷程檔：

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

如需詳細資訊，請參閱在 Oracle GoldenGate 中使用 OCI KMS 歷程檔加密。

永久清除歷程檔

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

Oracle 建議您先建立備份，再清除歷程檔。請參閱建立手動備份。接著，您可以下載備份並複查其內容 (<deployment-name>/var/lib/data/)。

若要永久清除 OCI GoldenGate 歷程檔，請執行下列動作：

在 OCI GoldenGate 部署主控台中，複查下列產生歷程檔的處理作業，並記下您要保留的歷程檔：
- 在「管理服務」中，複查每個 Extract 和 Replicat 的詳細資訊。(選取程序名稱，然後選取詳細資料。)
- 在配銷服務中，檢閱每個配銷路徑的詳細資訊 (如果有的話)。
- 在「接收端服務」中，複查每個「接收端路徑」(如果有的話) 的詳細資訊。
所有不在清單中的其他歷程檔都可以永久清除。
設定清除任務以清除部署主控台中未使用的歷程檔。
1. 在 OCI GoldenGate 部署主控台中，開啟「管理服務」的導覽功能表 (漢堡圖示)，然後選取組態。
2. 在組態頁面上，選取任務，然後選取清除軌跡。
3. 選取新增整個清除歷程檔工作 (加上圖示)。
4. 在「建立新的整個清除歷程檔」工作底下，完成下列欄位，然後選取送出：
  1. 在作業名稱中，輸入永久刪除作業的名稱。
  2. 針對歷程檔，輸入歷程檔的名稱，然後選取新增歷程檔 (加號圖示)。重複此步驟以新增其他歷程檔。選取的歷程檔會在您新增歷程檔時填入歷程檔的名稱。
  3. 如果您想要在所有 Extract 和 Replicat 處理作業以檔案完成之後 (如檢查點所示) 永久清除，請維持啟用使用檢查點。停用此選項可在不考慮檢查點和至少一個檔案 (如果未指定 MIN 值) 的情況下永久清除，或保留以 MIN 指定的檔案數目。
  注意：無法在部署主控台中刪除孤立檢查點檔案。使用 REST API 刪除獨立的檢查點檔案。
  1. 針對保留規則，指定要保留的「時數」、「天數」或「檔案數目」。
  2. 若為永久清除頻率，請指定執行此永久清除工作的頻率。
您可以視需要新增更多「清除任務」或停用這些任務。
使用管理用戶端清除未使用的歷程檔。
1. 在部署詳細資料頁面上，選取啟動管理用戶端。
  
  如果使用專用端點連線至 OCI GoldenGate 部署，請依照透過 Cloud Shell 連線至管理從屬端中的指示進行。
2. 執行下列命令來永久清除 Extract 已不再使用的歷程檔：
```
purge exttrail <trail-file-name>
```
  如需詳細資訊，請參閱 GoldenGate Command Line Reference 手冊中的 PURGE EXTTRAIL 。

使用 REST API 清除未使用的歷程檔。

開啟 Cloud Shell。

在 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 } ]}'