Traildateien verwalten

OCI GoldenGate-Traildateien summieren sich im Laufe der Zeit schnell auf. Ohne Löschaufgaben zur Verwaltung dieser Traildateien dauern tägliche Backups exponentiell länger und belegen dabei Compute-Ressourcen, die sonst anderweitig verwendet werden könnten.

Hinweis:

Diese Informationen gelten nur für Data Replication Deployments.
Standardmäßig löschen alle Datenreplikations-Deployments Traildateien, die älter als 21 Tage sind.

Traildateien anzeigen

Auf der Seite "Deployment-Details" können Sie Details zu Traildateien wie Größe, Sequenz, Producer und Consumer anzeigen.

So zeigen Sie Traildateien an:

Wählen Sie auf der GoldenGate-Überblicksseite Deployments aus.
Wählen Sie auf der Seite "Deployments" ein Deployment aus, um seine Details anzuzeigen, oder wählen Sie im Menü "Aktion" des Deployments Details anzeigen aus.
Wählen Sie auf der Seite "Deployment" die Option Traildateien aus.

Anhand dieser Informationen können Sie Traildateien identifizieren, die nicht mehr verwendet oder benötigt werden, und anschließend Löschaufgaben erstellen, um sie zu verwalten.

Traildateien verschlüsseln

Sie können Traildateien mit Verschlüsselungsprofilen in der Deployment-Konsole oder durch Erstellen von Masterverschlüsselungsschlüssel-Wallets verschlüsseln. In diesem Thema werden Verschlüsselungsprofile mit und ohne Resource Principals behandelt. Informationen zu Wallets mit Masterverschlüsselungsschlüsseln finden Sie unter Wallets mit Verschlüsselungsschlüsseln verwalten.

Bevor Sie beginnen

Zugriff auf den Vault-Service und einen erstellten Vault.

Hinweis: Ein Virtual Private Vault ist nicht erforderlich.
Die mindestens erforderlichen Policys wurden hinzugefügt, damit OCI GoldenGate den Vault-Service verwenden kann.

Mit Resource Principal verschlüsseln

Ein Resource Principal ist ein Feature von Identity and Access Management (IAM), das Ressourcen autorisiert, als Hauptakteure zu fungieren, die Aktionen für Ihre Ressourcen ausführen. Jede Ressource hat ihre eigene Identität und authentifiziert sich mit den ihr hinzugefügten Zertifikaten. Diese Zertifikate werden automatisch erstellt, Ressourcen zugewiesen und rotiert, sodass Sie keine eigenen Zugangsdaten für den Zugriff auf die Ressource erstellen und verwalten müssen.

Mit Resource Principals können Sie auf Ihren Vault-Schlüssel zugreifen, mit dem Sie dann Traildateien verschlüsseln können. Dazu muss Ihr Deployment Zugriff auf den ausgewählten Vault-Schlüssel haben. Stellen Sie sicher, dass Sie die oben in "Traildateien verschlüsseln" aufgeführten Anforderungen geprüft haben, insbesondere die mindestens erforderlichen Policys für den Vault-Service.

So verschlüsseln Sie Traildateien mit einem Resource Principal:

Wählen Sie auf der Seite mit den Deployment-Details die Option Konsole starten aus.
Blenden Sie in der Deployment-Konsole im Navigationsmenü die Option Verschlüsselung ein, und wählen Sie Profile aus.
Wählen Sie unter Oracle Cloud Infrastructure mit Resource Principal die Option Plug-in-Verschlüsselungsprofil hinzufügen aus.
Füllen Sie im Bereich "Verschlüsselungsprofil erstellen" die folgenden Felder aus:
1. Geben Sie unter Profilname einen Namen für dieses Verschlüsselungsprofil ein.
2. (Optional) Fügen Sie eine Beschreibung ein.
3. Fügen Sie die OCI Vault-Schlüssel-OCID Ihres OCI Vault ein. Sie finden dies auf der Detailseite des Verschlüsselungsschlüssels in Ihrem Vault.
4. Geben Sie den kryptografischen Endpunkt für OCI Vault auf der Seite mit den Vault-Details ein.
Klicken Sie auf Weiterleiten.

Ohne Resource Principal verschlüsseln

So verschlüsseln Sie Traildateien ohne einen Resource Principal:

Wählen Sie auf der Seite mit den Deployment-Details die Option Konsole starten aus.
Blenden Sie in der Deployment-Konsole im Navigationsmenü die Option Verschlüsselung ein, und wählen Sie Profile aus.
Wählen Sie unter Oracle Cloud Infrastructure die Option Plug-in-Verschlüsselungsprofil hinzufügen aus.
Füllen Sie im Bereich "Verschlüsselungsprofil erstellen" die folgenden Felder aus:
1. Geben Sie einen Profilnamen ein.
2. Geben Sie eine Beschreibung ein.
3. Fügen Sie die Crypto-Endpunkt-URL ein, die Sie auf der Vault-Detailseite finden.
4. Fügen Sie die Mandanten-OCID ein. Diese finden Sie auf der Seite mit den Mandantendetails.
5. Fügen Sie die Schlüssel-OCID ein. Diese finden Sie auf der Seite mit den Schlüsseldetails.
6. Fügen Sie die Benutzer-OCID ein, die Sie auf Ihrer Benutzerprofilseite finden.
7. Laden Sie den API-Schlüssel hoch, den Sie im Abschnitt Token und Schlüssel Ihrer Benutzerprofilseite generieren können, oder fügen Sie ihn ein.
8. Fügen Sie den Key Fingerprint ein, der mit Ihrem API-Schlüssel verknüpft ist.
Klicken Sie auf Weiterleiten.

Weitere Informationen finden Sie unter OCI KMS-Traildateiverschlüsselung in Oracle GoldenGate verwenden.

Traildateien löschen

Oracle empfiehlt, dass Sie zuerst ein Backup erstellen, bevor Sie Traildateien löschen. Siehe Manuelles Backup erstellen Anschließend können Sie das Backup herunterladen und dessen Inhalt prüfen (<deployment-name>/var/lib/data/).

So löschen Sie OCI GoldenGate-Traildateien:

Überprüfen Sie in der OCI GoldenGate-Deployment-konsole die folgenden Prozesse, die Traildateien generieren, und notieren Sie die Traildateien, welche Sie beibehalten möchten:
- Prüfen Sie im Administrationsservice die Details zu jedem Extract und Replicat. (Wählen Sie den Prozessnamen, und wählen Sie Details.)
- Prüfen Sie im Verteilungsservice die Details der einzelnen Verteilungspfade (sofern vorhanden).
- Prüfen Sie im Empfangsservice die Details jedes Empfangspfades (falls vorhanden).
Alle anderen Traildateien, die nicht in Ihrer Liste enthalten sind, können gelöscht werden.
Legen Sie Löschaufgaben fest, um nicht verwendete Traildateien in der Deployment-Konsole zu bereinigen.
1. Öffnen sie in der OCI GoldenGate-Deployment-konsole das Navigationsmenü (Hamburger-Symbol) für den Administrationsservice, und wählen Sie Konfiguration aus.
2. Wählen Sie auf der Seite Konfiguration die Option Aufgaben, Trails löschen aus.
3. Wählen Sie Aufgabe zum Löschen von Trails hinzufügen (Plussymbol).
4. Füllen Sie unter "Neue Aufgabe zum Erstellen von Trails erstellen" die folgenden Felder und wählen Sie Weiterleiten aus:
  1. Geben Sie unter Vorgangsname einen Namen für die Löschaufgabe an.
  2. Geben Sie unter Trail einen Namen einer Traildatei an, und wählen Sie Trail hinzufügen (Plussymbol). Wiederholen Sie diesen Schritt, um weitere Traildateien hinzuzufügen. Ausgewählte Trails wird mit den Namen der von Ihnen hinzugefügten Traildatei aufgefüllt.
  3. Lassen Sie Checkpoints nutzen aktiviert, wenn Sie die Daten nach dem Abschluss aller Extract- und Replicat-Prozesse, wie durch Checkpoints angegeben, löschen möchten. Wenn diese Option deaktiviert wird, können Sie Dateien ohne Berücksichtigung von Checkpoints löschen, wobei mindestens eine Datei (wenn kein MIN-Wert angegeben ist) oder die Anzahl der mit MIN angegebene Dateien beibehalten werden.
  Hinweis: Verwaiste Checkpoint-Dateien können nicht in der Deployment-Konsole gelöscht werden. Mit REST-APIs können Sie verwaiste Checkpoint-Dateien löschen.
  1. Geben Sie unter Beibehaltungsregel die Stunden, Tage oder der Anzahl der beizubehaltenden Dateien ein.
  2. Geben Sie unter Löschintervall die Häufigkeit an, mit der diese Löschaufgabe ausgeführt werden soll.
Sie können weitere Löschaufgaben hinzufügen oder sie nach Bedarf deaktivieren.
Bereinigen Sie nicht verwendete Traildateien mit dem Admin-Client.
1. Wählen Sie auf der Seite "Deployment-Details" die Option Admin-Client starten.
  
  Wenn Sie eine Verbindung zu einem OCI GoldenGate-Deployment mit einem privaten Endpunkt herstellen, befolgen Sie die Anweisungen unter Verbindung zum Admin-Client über Cloud Shell herstellen.
2. Führen Sie den folgenden Befehl aus, um Traildateien zu löschen, die nicht mehr von Extracts verwendet werden:
```
purge exttrail <trail-file-name>
```
  Weitere Informationen finden Sie unter PURGE EXTTRAIL in der GoldenGate-Befehlszeilenreferenz.

Bereinigen Sie nicht verwendete Traildateien mit REST-APIs.

Cloud Shell öffnen.

Führen Sie in Cloud Shell den folgenden REST-API-Aufruf zum OCI GoldenGate-Deployment aus. Stellen Sie sicher, dass Sie die Platzhalter durch die tatsächlichen Werte des Deployments ersetzen.

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

Um sicherzustellen, dass alle Traildateien gelöscht werden, können Sie einen der folgenden Schritte ausführen:

Wählen Sie auf der Seite mit den Deployment-Details in der Oracle Cloud-Konsole die Option Traildateien, und wählen Sie Aktualisieren aus, um die Liste der Traildateien zu prüfen.
Erstellen Sie ein weiteres manuelles Backup, und überprüfen Sie den Inhalt des Backups für die Traildateien, deren Aufbewahrung Sie beibehalten möchten. Beachten Sie die Reduzierung der Aggregatgröße und die Geschwindigkeit, in der das Backup jetzt abgeschlossen wird.

REST-Beispiele

Die folgenden Beispiele zeigen, wie Sie Traildateien unter verschiedenen Bedingungen entfernen.

Beispiel 1

Alle Traildateien löschen, deren Namen mit "IL" übereinstimmen:

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

Beispiel 2

Alle Traildateien löschen, wie durch das Sternchen (`) angegeben, im Unterverzeichnis 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 } ]}'

Beispiel 3

Alle L1 Extract-Traildateien löschen:

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

Beispiel 4

Alle Traildateien löschen, deren Namen mit "L1" übereinstimmen, aber die Dateien der letzten 10 Stunden beibehalten:

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

Beispiel 5

Löschen Sie mit USECHECKPOINTS alle mehr als einen Tag alten L1 Extract Trail-Dateien:

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

Beispiel 6

Alle L1 Extract-Traildateien löschen, die mehr als einen Tag alt sind:

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