Gérer les fichiers de piste

Les fichiers de piste de GoldenGate pour OCI s'accumulent rapidement au fil du temps. Si des tâches d'épuration ne sont pas mises en place pour gérer ces fichiers de piste, l'exécution des sauvegardes quotidiennes prend de plus en plus de temps et utilisent des ressources de calcul qui pourraient être utilisées ailleurs.

Note :

Ces informations s'appliquent uniquement aux déploiements de réplication de données.

Rubriques connexes

Gérer les sauvegardes de déploiement

Voir les fichiers de piste

Vous pouvez voir les détails des fichiers de piste tels que la taille, la séquence, les producteurs et les consommateurs dans la page des détails du déploiement.

Pour voir les fichiers de piste :

Dans la page Aperçu de GoldenGate, cliquez sur Déploiements.
Dans la page Déploiements, sélectionnez un déploiement pour en afficher les détails ou sélectionnez Voir les détails dans le menu Action du déploiement.
Dans la page des détails du déploiement, cliquez sur Fichiers de piste.

Utilisez ces informations pour identifier les fichiers de piste qui ne sont plus utilisés ou nécessaires, puis créez des tâches d'épuration pour les gérer.

Chiffrer les fichiers de piste

Vous pouvez chiffrer les fichiers de piste à l'aide de profils de chiffrement dans la console de déploiement ou en créant des portefeuilles de clés de chiffrement principaux. Cette rubrique décrit les profils de chiffrement avec et sans principaux de ressource. Pour plus d'informations sur les portefeuilles de clés de chiffrement principales, voir Gérer les portefeuilles de clés de chiffrement.

Avant de continuer, assurez-vous d'avoir :

Accès au service de chambre forte et à une chambre forte créée.

Note :
Aucune chambre forte privée virtuelle n'est requise.
Ajout des politiques minimales requises pour OCI GoldenGate afin d'utiliser le service de chambre forte.

Chiffrer avec le principal de ressource

Un principal de ressource est une fonction du service de gestion des identités et des accès (IAM) qui autorise les ressources à agir en tant qu'acteurs principaux effectuant des actions sur vos ressources. Chaque ressource possède sa propre identité et elle s'authentifie à l'aide des certificats qui y sont ajoutés. Ces certificats sont créés automatiquement, affectés aux ressources et soumis à une rotation, ce qui vous évite d'avoir à créer et à gérer vos propres données d'identification pour accéder à la ressource.

Vous pouvez utiliser des principaux de ressource pour accéder à votre clé du service de chambre forte, que vous pouvez ensuite utiliser pour chiffrer les fichiers de piste. Pour ce faire, votre déploiement doit avoir accès à la clé de chambre forte sélectionnée. Assurez-vous d'avoir vérifié les exigences indiquées ci-dessus dans les fichiers de piste de chiffrement, en particulier les politiques minimales requises pour le service de chambre forte.

Pour chiffrer les fichiers de piste à l'aide d'un principal de ressource :

Dans la page des détails de votre déploiement, cliquez sur Lancer la console.
Dans la console de déploiement, dans le menu de navigation, développez Chiffrement, puis sélectionnez Profils.
Pour Infratstructure Oracle Cloud avec principal de ressource, cliquez sur Ajouter un profil de chiffrement de plugiciel.
Dans le panneau Créer un profil de chiffrement, remplissez les champs suivants :
1. Pour Nom du profil, entrez un nom pour ce profil de chiffrement.
2. (Facultatif) Ajoutez une description.
3. Collez l'OCID de la clé du service de chambre forte OCI de votre service de chambre forte OCI. Vous pouvez le trouver dans la page de détails de votre clé de chiffrement de votre chambre forte.
4. Entrez le point d'extrémité cryptographique pour le service de chambre forte OCI dans la page des détails du service de chambre forte.
Cliquez sur Soumettre.

Chiffrer sans principal de ressource

Pour chiffrer les fichiers de piste sans utiliser de principal de ressource :

Dans la page des détails de votre déploiement, cliquez sur Lancer la console.
Dans la console de déploiement, dans le menu de navigation, développez Chiffrement, puis sélectionnez Profils.
Pour Infratstructure Oracle Cloud, cliquez sur Ajouter un profil de chiffrement de plugiciel.
Dans le panneau Créer un profil de chiffrement, remplissez les champs suivants :
1. Entrez un nom de profil.
2. Entrer une description.
3. Collez dans l'URL du point d'extrémité Crypto, que vous pouvez trouver dans la page des détails de votre chambre forte.
4. Collez l'OCID de la location dans la page des détails de la location.
5. Collez l'OCID de la clé dans la page des détails de la clé.
6. Collez l'OCID de l'utilisateur dans la page de votre profil d'utilisateur.
7. Chargez ou collez la clé d'API, que vous pouvez générer à partir de la section Jeux et clés de votre page de profil d'utilisateur.
8. Collez votre empreinte numérique de la clé, associée à votre clé d'API.
Cliquez sur Soumettre.

Pour plus d'informations, voir Utilisation du chiffrement du fichier de piste du service de gestion des clés pour OCI dans Oracle GoldenGate.

Épurer les fichiers de piste

Oracle recommande de créer d'abord une sauvegarde avant d'épurer les fichiers de piste. Voir Créer une sauvegarde manuelle. Vous pouvez ensuite télécharger la sauvegarde et vérifier son contenu (<deployment-name>/var/lib/data/).

Pour épurer les fichiers de piste de GoldenGate pour OCI :

Dans la console de déploiement d'OCI GoldenGate, vérifiez les processus suivants qui génèrent des fichiers de piste et notez les fichiers de piste que vous voulez conserver :
- Dans le service d'administration, vérifiez les détails de chaque processus d'extraction et de réplication. (Cliquez sur le nom du processus, puis sélectionnez Détails.)
- Dans le service de distribution, vérifiez les détails de chaque chemin de distribution (le cas échéant).
- Dans le service récepteur, vérifiez les détails de chaque chemin récepteur (s'il en existe).
Tous les autres fichiers de piste qui ne figurent pas sur votre liste peuvent être épurés.
Configurez des tâches d'épuration pour nettoyer les fichiers de piste non utilisés dans la console de déploiement.
1. Dans la console de déploiement d'OCI GoldenGate, ouvrez le menu de navigation (icône hamburger) du service d'administration, puis sélectionnez Configuration.
2. Dans la page Configuration, cliquez sur Tâches, puis sur Éliminer les pistes.
3. Cliquez sur Ajouter une tâche d'épuration de pistes (icône plus).
4. Sous Créer une tâche d'épuration de pistes, remplissez les champs suivants, puis cliquez sur Soumettre :
  1. Pour Nom de l'opération, entrez un nom pour la tâche d'élimination.
  2. Pour Piste, entrez le nom d'un fichier de piste, puis cliquez sur Ajouter une piste (icône plus). Répétez cette étape pour ajouter des fichiers de piste. La liste Pistes sélectionnées est alimentée avec les fichiers de piste que vous ajoutez.
  3. Laissez l'option Utiliser des points de vérification activée si vous voulez effectuer l'épuration une fois que les processus d'extraction et de réplication en ont terminé avec les fichiers, comme indiqué par les points de vérification. La désactivation de cette option permet d'effectuer l'épuration sans tenir compte des points de contrôle et du minimum d'un fichier (si aucune valeur MIN n'est spécifiée). Sinon, le nombre de fichiers spécifiés par la valeur MIN est conservé.
    
    Note :
    Les fichiers de point de reprise orphelins ne peuvent pas être supprimés dans la console de déploiement. Utiliser des API REST pour supprimer des fichiers de point de vérification orphelins.
  4. Pour Règle de conservation, spécifiez les heures, les jours ou le nombre de fichiers à conserver.
  5. Pour Fréquence d'élimination, spécifiez la fréquence à laquelle exécuter cette tâche d'élimination.
Vous pouvez ajouter d'autres tâches d'épuration ou les désactiver selon vos besoins.
Nettoyer les fichiers de piste inutilisés à l'aide du client d'administration.
1. Dans la page des détails du déploiement, cliquez sur Lancer le client d'administration.
  Si vous êtes connecté à un déploiement OCI GoldenGate avec un point d'extrémité privé, suivez les instructions sous Se connecter au client d'administration au moyen de Cloud Shell.
2. Exécutez la commande suivante pour épurer les fichiers de piste qui ne sont plus utilisés par les extractions :
```
purge exttrail <trail-file-name>
```
  Pour plus d'informations, consultez le document PURGE EXTTRAIL dans le guide Informations de référence sur la ligne de commandeGoldenGate.

Nettoyez les fichiers de piste non utilisés à l'aide des API REST.

Ouvrir Cloud Shell.

Dans Cloud Shell, exécutez l'appel d'API REST suivant pour le déploiement OCI GoldenGate. Veillez à remplacer les paramètres fictifs par les valeurs réelles de votre déploiement.

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

Pour vous assurer que tous les fichiers de piste sont supprimés, vous pouvez effectuer l'une des opérations suivantes :

Dans la page des détails du déploiement de la console Oracle Cloud, sélectionnez Fichiers de piste, puis cliquez sur Actualiser pour vérifier la liste des fichiers de piste.
Créez une autre sauvegarde manuelle et vérifiez le contenu de la sauvegarde pour les fichiers de piste à conserver. Notez que la taille globale diminue et que la sauvegarde est exécutée plus rapidement.

Exemples REST

Les exemples suivants montrent comment supprimer des fichiers de piste dans différentes conditions :

Exemple 1 : Épurer tous les fichiers de piste dont le nom correspond à "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 } ]}'

Exemple 2 : Épurer tous les fichiers de piste, comme indiqué par l'astérisque (*), situés dans le sous-répertoire 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 } ]}'

Exemple 3 : Épurer tous les fichiers de piste d'extraction 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 } ]}'

Exemple 4 : Épurer tous les fichiers de piste dont le nom correspond à "L1" mais conserver les fichiers des 10 dernières heures :

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

Exemple 5 : Épurer tous les fichiers de piste d'extraction L1 datant de plus d'un jour à l'aide de USECHECKPOINTS :

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

Exemple 6 : Épurer tous les fichiers de piste d'extraction L1 qui datent de plus d'un jour :

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

Informations sur le titre et les droits d'auteur

Oracle et/ou ses sociétés affiliées.