Capture et réexécution entre les instances de base de données Autonomous AI

Lorsque vous commencez la capture de la charge globale sur un système de production, toutes les demandes des clients externes dirigées vers Oracle Database sont suivies et stockées dans des fichiers binaires appelés fichiers de capture.

Une capture de charge globale entraîne la création de deux sous-répertoires, cap et capfiles, qui contiennent les fichiers de capture. Les fichiers de capture fournissent toutes les informations pertinentes sur la demande client, notamment les détails de la transaction, les valeurs attachées et le texte SQL. Les fichiers de capture sont indépendants de la plate-forme et peuvent donc être transférés sur un autre système.

Exécutez DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE pour lancer la capture de charge globale sur une instance de base de données Autonomous AI.

Pour plus d'informations, reportez-vous à Clonage, déplacement ou mise à niveau d'une instance de base de données Autonomous AI.

Pour lancer une capture de charge globale sur votre instance de base de données Autonomous AI, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

Exemple de lancement d'une capture de charge globale :

BEGIN 
   DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE(
        capture_name => 'test',
        duration     => 60);
   END;
/

La capture de charge globale démarre sur votre instance de base de données Autonomous AI.

Les paramètres sont les suivants :

• capture_name : nom de la capture de charge globale.

• duration : durée (en minutes) pendant laquelle vous devez capturer la charge globale. Ce paramètre est facultatif.

Pour plus d'informations, reportez-vous à Procédure START_WORKLOAD_CAPTURE.

Evénements de capture de charge globale

Vous pouvez vous abonner à l'événement Information com.oraclecloud.databaseservice.autonomous.database.information pour être averti au début de START_WORKLOAD_CAPTURE. Pour plus d'informations, reportez-vous à (Facultatif) S'abonner aux événements d'information à notifier des détails de capture et de réexécution.

Vues de capture et de réexécution de charge globale

Vous trouverez des informations sur la capture et la réexécution de la charge globale dans les vues DBA_CAPTURE_REPLAY_STATUS et DBA_CAPTURE_REPLAY_HISTORY. Pour plus d'informations, reportez-vous à DBA_CAPTURE_REPLAY_STATUS View et à DBA_CAPTURE_REPLAY_HISTORY View.

Pour annuler une capture de charge globale, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

Exemple :

BEGIN
    DBMS_CLOUD_ADMIN.CANCEL_WORKLOAD_CAPTURE;
END;
/

La capture de charge globale en cours est annulée et une actualisation est effectuée sur le clone actualisable.

Vous pouvez interroger la vue DBA_CAPTURE_REPLAY_STATUS pour vérifier le statut d'annulation de la charge globale.

Pour plus d'informations, reportez-vous à DBA_CAPTURE_REPLAY_STATUS View.

Pour plus d'informations, reportez-vous à Procédure CANCEL_WORKLOAD_CAPTURE.

Exemple pour terminer une capture de charge globale sur votre instance de base de données Autonomous AI :

BEGIN
    DBMS_CLOUD_ADMIN.FINISH_WORKLOAD_CAPTURE;
END;
/

Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN. Lorsque vous exécutez cette procédure, un fichier de capture de charge globale est téléchargé dans la banque d'objets sous forme de fichier ZIP.

Pour plus d'informations, reportez-vous à Procédure FINISH_WORKLOAD_CAPTURE.

Evénements de capture de charge globale

Vous pouvez vous abonner à l'événement d'information com.oraclecloud.databaseservice.autonomous.database.information pour être informé d'une capture de charge globale, qui inclut les éléments suivants :

• Fin de FINISH_WORKLOAD_CAPTURE.

• Champ captureDownloadURL contenant l'URL de demande pré-authentifiée permettant d'accéder à la capture et aux rapports dans la banque d'objets. La capture et les rapports sont valides pendant sept (7) jours à compter de la date de génération de l'URL de demande pré-authentifiée.

Pour plus d'informations, reportez-vous à (Facultatif) S'abonner aux événements d'information à notifier des détails de capture et de réexécution.

Vues de capture et de réexécution de charge globale

Vous pouvez interroger la vue DBA_CAPTURE_REPLAY_STATUS pour vérifier le statut d'une capture de charge globale terminée. Pour plus d'informations, reportez-vous à DBA_CAPTURE_REPLAY_STATUS View.

Vous trouverez des informations sur la capture et la réexécution de la charge globale dans la vue DBA_CAPTURE_REPLAY_HISTORY. Pour plus d'informations, reportez-vous à DBA_CAPTURE_REPLAY_HISTORY View.

Vous pouvez interroger les colonnes ID, NAME, START_TIME et END_TIME de la vue DBA_WORKLOAD_CAPTURES pour extraire les détails de la capture de charge globale. Pour plus d'informations, reportez-vous à DBA_WORKLOAD_CAPTURES.

Vous disposez de deux options pour préparer un clone actualisable afin de réexécuter une capture de charge globale. Vous pouvez exécuter DBMS_CLOUD_ADMIN.PREPARE_REPLAY pour préparer automatiquement un clone actualisable pour une réexécution de charge globale. Cette procédure actualise le clone actualisable à l'heure de début de la capture et déconnecte le clone actualisable. Vous pouvez également préparer manuellement un clone actualisable pour réexécuter une capture de charge globale.

Préparation automatique d'un clone actualisable pour la réexécution de charge globale

Exemple de préparation automatique d'un clone actualisable pour une réexécution de charge globale :

BEGIN
 DBMS_CLOUD_ADMIN.PREPARE_REPLAY (
    capture_name    'test'
END;
/

Pour exécuter cette procédure, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

DBMS_CLOUD_ADMIN.PREPARE_REPLAY effectue les opérations suivantes :

• Actualise le clone actualisable avec l'horodatage de début de capture.

• Déconnecte le clone actualisable.

A ce stade, vous pouvez éventuellement modifier le clone actualisable avant de réexécuter une capture. Par exemple, modifier les valeurs des paramètres et activer/désactiver certaines fonctionnalités pour voir l'impact sur la réexécution.

Préparation manuelle d'un clone actualisable pour la réexécution de charge globale

Ces étapes de clone actualisable manuellement ne sont pas requises lorsque vous préparez automatiquement un clone actualisable en exécutant DBMS_CLOUD_ADMIN.PREPARE_REPLAY.

Pour préparer manuellement une réexécution de charge globale, procédez comme suit :

1. Recherchez l'horodatage de début de capture en interrogeant la vue DBA_WORKLOAD_CAPTURES. Pour plus d'informations, reportez-vous à DBA_WORKLOAD_CAPTURES.

2. Actualisez le clone actualisable avec l'horodatage de début de capture. Pour plus d'informations, reportez-vous à la section Actualisation d'un clone actualisable sur Autonomous AI Database.

3. Déconnectez manuellement le clone actualisable. Pour plus d'informations, reportez-vous à Déconnexion d'un clone actualisable de la base de données source.

4. Avant de réexécuter une capture, vous pouvez éventuellement apporter des modifications au clone actualisable. Par exemple, modifier les valeurs des paramètres, activer/désactiver certaines fonctionnalités pour voir l'impact sur la réexécution.

Exécutez la procédure DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD pour lancer la réexécution de la charge globale sur la base de données. Vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN pour exécuter DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD.

Vous pouvez réexécuter une charge globale capturée sur un clone actualisable ou sur un clone complet de l'instance de base de données Autonomous AI à partir de laquelle la charge globale a été capturée. Les cibles de capture et de réexécution doivent présenter un état logique cohérent.

Réexécuter la charge globale sur un clone actualisable

L'exemple suivant télécharge les fichiers de capture à partir d'Object Storage, réexécute la charge globale capturée et télécharge un rapport de réexécution vers Object Storage.

BEGIN 
  DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
      capture_name => 'CAP_TEST1');
END;
/

Le paramètre CAPTURE_NAME indique le nom de la capture de charge globale. Ce paramètre est obligatoire.

Réexécuter la charge globale sur un clone complet

L'exemple suivant permet de télécharger des fichiers de capture à partir d'Object Storage, de réexécuter la charge globale capturée sur le clone et de télécharger un rapport de réexécution vers Object Storage.

BEGIN 
  DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
       capture_name                => 'CAP_TEST1',        
       capture_source_tenancy_ocid => 'OCID1.TENANCY.REGION1..ID1',         
       capture_source_db_name      => 'ADWFINANCE');
END;
/

Le paramètre CAPTURE_NAME indique le nom de la capture de charge globale. Ce paramètre est obligatoire.

Le paramètre CAPTURE_SOURCE_TENANCY_OCID indique l'OCID de location source de la capture de charge globale. Ce paramètre est obligatoire lors de l'exécution de la capture de charge globale dans un clone complet.

Le paramètre CAPTURE_SOURCE_DB_NAME indique le nom de la base de données source de la capture de charge globale. Ce paramètre est obligatoire lors de l'exécution de la capture de charge globale dans un clone complet.

Pour plus d'informations, reportez-vous à Procédure REPLAY_WORKLOAD.

Evénements de réexécution de charge globale

Abonnez-vous à l'événement Information com.oraclecloud.databaseservice.autonomous.database.information pour être informé des éléments suivants :

• Début et fin d'un élément REPLAY_WORKLOAD.

• Lien Banque d'objets permettant de télécharger les rapports de réexécution. L'événement fournit une URL de demande pré-authentifiée pour accéder aux rapports dans le champ replayDownloadURL. Les rapports sont valides pendant sept (7) jours à compter de la date de génération de l'URL de demande pré-authentifiée.

Pour plus d'informations, reportez-vous à Evénements d'information sur Autonomous AI Database.

Vues de capture et de réexécution de charge globale

Vous pouvez interroger la vue DBA_CAPTURE_REPLAY_STATUS pour vérifier le statut de réexécution de la charge globale.

Pour plus d'informations, reportez-vous à DBA_CAPTURE_REPLAY_STATUS View.

Vous trouverez des informations sur la capture et la réexécution de la charge globale dans la vue DBA_CAPTURE_REPLAY_HISTORY. Pour plus d'informations, reportez-vous à DBA_CAPTURE_REPLAY_HISTORY View.