Saisir et réexécuter entre les instances de base de données d'intelligence artificielle autonome

Lorsque vous démarrez la capture de la charge globale sur un système de production, toutes les demandes des clients externes dirigés vers Oracle Database font l'objet d'un suivi et sont stockées dans des fichiers binaires appelés fichiers de capture.

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

Exécutez DBMS_CLOUD_ADMIN.START_WORKLOAD_CAPTURE pour lancer la saisie de charge de travail sur une instance de base de données d'intelligence artificielle autonome.

Pour plus d'informations, voir Cloner, déplacer ou mettre à niveau une instance de base de données d'IA autonome.

Pour lancer une saisie de charge de travail sur votre instance de base de données d'intelligence artificielle autonome, vous devez être connecté en tant qu'utilisateur ADMIN ou disposer du privilège EXECUTE sur DBMS_CLOUD_ADMIN.

Exemple pour lancer une capture de charge globale :

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

Cela démarre la saisie de la charge de travail sur votre instance de base de données d'IA autonome.

Les paramètres sont les suivants :

• capture_name : Nom de la saisie de charge de travail.

• duration : Durée (en minutes) pendant laquelle vous devez saisir la charge de travail. Ce paramètre est facultatif.

Pour plus d'informations, voir ProcédureSTART_WORKLOAD_CAPTURE.

Événements de saisie de charge de travail

Vous pouvez vous abonner à l'événement Information com.oraclecloud.databaseservice.autonomous.database.information pour en être avisé au début de START_WORKLOAD_CAPTURE. Pour plus d'informations, voir (Facultatif) S'abonner à des événements d'information à aviser des détails de saisie et de réexécution.

Vues de capture et de réexécution de la charge de travail

Vous pouvez trouver des informations sur la saisie et la réexécution de la charge de travail dans les vues DBA_CAPTURE_REPLAY_STATUS et DBA_CAPTURE_REPLAY_HISTORY. Pour plus d'informations, voir Vue DBA_CAPTURE_REPLAY_STATUS et Vue DBA_CAPTURE_REPLAY_HISTORY.

Pour annuler une saisie de charge de travail, 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;
/

Cela annule la capture de charge globale en cours et effectue une actualisation sur le clone actualisable.

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

Pour plus d'informations, voir Vue DBA_CAPTURE_REPLAY_STATUS.

Pour plus d'informations, voir ProcédureCANCEL_WORKLOAD_CAPTURE.

Exemple pour terminer une saisie de charge de travail sur votre instance de base de données IA autonome :

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 saisie de charge de travail est chargé dans le magasin d'objets en tant que fichier zip.

Pour plus d'informations, voir ProcédureFINISH_WORKLOAD_CAPTURE.

Événements de saisie de charge de travail

Vous pouvez vous abonner à l'événement Informations com.oraclecloud.databaseservice.autonomous.database.information pour être avisé d'une saisie de charge de travail, notamment :

• L'achèvement de FINISH_WORKLOAD_CAPTURE.

• Champ captureDownloadURL contenant l'URL de la demande préauthentifiée pour accéder à la saisie et aux rapports dans le magasin d'objets. La saisie 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, voir (Facultatif) S'abonner à des événements d'information à aviser des détails de saisie et de réexécution.

Vues de capture et de réexécution de la charge de travail

Vous pouvez interroger la vue DBA_CAPTURE_REPLAY_STATUS pour vérifier le statut d'une saisie de charge de travail terminée. Pour plus d'informations, voir Vue DBA_CAPTURE_REPLAY_STATUS.

Vous pouvez trouver des informations sur la capture et la réexécution de charge de travail dans la vue DBA_CAPTURE_REPLAY_HISTORY. Pour plus d'informations, voir Vue DBA_CAPTURE_REPLAY_HISTORY.

Vous pouvez interroger les colonnes ID, NAME, START_TIME et END_TIME de la vue DBA_WORKLOAD_CAPTURES pour extraire les détails de votre saisie de charge de travail. Pour plus d'informations, voir 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 de travail. Cette procédure actualise le clone actualisable jusqu'à l'heure de début de la capture et déconnecte le clone actualisable. Vous avez également la possibilité de préparer manuellement un clone actualisable pour réexécuter une capture de charge globale.

Préparer automatiquement un clone actualisable pour la réexécution de la charge de travail

Exemple pour préparer automatiquement un clone actualisable pour une réexécution de charge de travail :

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 en fonction de l'horodatage de début de la capture.

• Déconnecte le clone actualisable.

Facultativement, avant de réexécuter une capture, vous pouvez apporter des modifications à un clone actualisable. 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éparer manuellement un clone actualisable pour la réexécution de la charge de travail

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 la capture en interrogeant la vue DBA_WORKLOAD_CAPTURES. Pour plus d'informations, voir DBA_WORKLOAD_CAPTURES.

2. Actualisez le clone actualisable selon l'horodatage de début de la capture. Pour plus d'informations, voir Actualiser un clone actualisable sur une base de données d'IA autonome.

3. Déconnectez manuellement le clone actualisable. Pour plus d'informations, voir Déconnecter un clone actualisable de la base de données source.

4. Facultativement, avant de réexécuter une capture, vous pouvez 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 charge de travail sur votre 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 de travail capturée sur un clone actualisable ou sur un clone complet de l'instance de base de données d'IA autonome à partir de laquelle la charge de travail a été capturée. Les cibles de capture et de réexécution doivent être dans un état logique cohérent.

Réexécuter la charge de travail sur un clone actualisable

L'exemple suivant télécharge les fichiers de capture à partir du service de stockage d'objets, réexécute la charge de travail capturée et charge un rapport de réexécution dans le service de stockage d'objets.

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

Le paramètre CAPTURE_NAME spécifie le nom de la saisie de charge de travail. Ce paramètre est obligatoire.

Réexécuter la charge de travail sur un clone complet

Cet exemple suivant télécharge les fichiers de capture à partir du stockage d'objets, réexécute la charge de travail capturée sur le clone et charge un rapport de réexécution dans le stockage d'objets.

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 spécifie le nom de la saisie de charge de travail. Ce paramètre est obligatoire.

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

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

Pour plus d'informations, voir ProcédureREPLAY_WORKLOAD.

Événements de réexécution de charge de travail

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

• Le début et l'achèvement d'un REPLAY_WORKLOAD.

• Lien du magasin d'objets pour 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, voir Événements d'informations sur Autonomous AI Database.

Vues de capture et de réexécution de la charge de travail

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

Pour plus d'informations, voir Vue DBA_CAPTURE_REPLAY_STATUS.

Vous pouvez trouver des informations sur la capture et la réexécution de charge de travail dans la vue DBA_CAPTURE_REPLAY_HISTORY. Pour plus d'informations, voir Vue DBA_CAPTURE_REPLAY_HISTORY.