Lorsque vous commencez la capture de charge globale sur un système de production, toutes les demandes de clients externes envoyées à Oracle Database font l'objet d'un suivi et d'un stockage 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 Autonomous Database.

Pour plus d'informations, reportez-vous à Clonage, déplacement ou mise à niveau d'une instance Autonomous Database.

Pour lancer une capture de charge globale sur votre instance Autonomous Database, 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;
/

Cette opération démarre la capture de charge globale sur votre instance Autonomous Database.

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 à START_WORKLOAD_CAPTURE Procédure.

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) Abonnement 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;
/

Cette opération annule la capture de charge globale en cours et actualise le clone actualisable.

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

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

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

Exemple pour terminer une capture de charge globale sur votre instance Autonomous Database :

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 à FINISH_WORKLOAD_CAPTURE Procédure.

Evénements de capture de charge globale

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

• Exécution 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) Abonnement 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 afin de préparer automatiquement un clone actualisable pour une réexécution de charge globale. 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 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 la capture.

• Déconnecte le clone actualisable.

A ce stade, vous pouvez éventuellement apporter des modifications à un clone actualisable avant de réexécuter une capture. Par exemple, la modification des valeurs de paramètre et l'activation/désactivation de 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 clonage actualisable manuel 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, reportez-vous à DBA_WORKLOAD_CAPTURES.

2. Actualisez le clone actualisable avec l'horodatage de début de la capture. Pour plus d'informations, reportez-vous à Actualisation d'un clone actualisable sur Autonomous 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 modifier le clone actualisable. Par exemple, la modification des valeurs de paramètre, l'activation/désactivation de 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 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 Autonomous Database à 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 télécharge des fichiers de capture à partir d'Object Storage, réexécute la charge globale capturée sur le clone et télécharge 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 à REPLAY_WORKLOAD Procédure.

Evénements de réexécution de la 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'une opération REPLAY_WORKLOAD.

• Lien Object Store 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, reportez-vous à événements d'information sur Autonomous 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.

Cette option Capture-Replay est particulièrement utile lorsque vous souhaitez tester vos charges globales exécutées sur Oracle Database 19c avant la mise à niveau vers Oracle Database 23ai.

Procédez comme suit pour réexécuter vos charges globales sur une autre version de base de données :

1. (Facultatif) Abonnement aux événements d'information à notifier des détails de capture et de réexécution

2. Capturez vos charges globales sur une instance Autonomous Database avec Oracle Database 19c. Pour plus d'informations, reportez-vous à Capture d'une charge globale sur une instance Autonomous Database.

3. Exécutez DBMS_CLOUD_ADMIN.FINISH_WORKLOAD_CAPTURE pour terminer la capture de la charge globale sur l'instance de base de données 19c sourceAutonomous Oracle Database.

4. Préparez le clone actualisable Oracle Database 23ai cible. Pour plus d'informations, reportez-vous à Préparation d'un clone actualisable pour la réexécution de charge globale.

5. Une fois que vous avez terminé la capture de la charge globale et préparé le clone actualisable de la cible Oracle Database 23ai, réexécutez la charge globale sur la cible. Pour plus d'informations, reportez-vous à Réexécution d'une charge globale sur une instance Autonomous Database.

Lorsque vous commencez la capture de charge globale sur le système de production, toutes les demandes de clients externes envoyées à 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.

Reportez-vous à Capture de charge globale pour capturer une charge globale sur une base de données sur site.

Exécutez DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD pour lancer la réexécution de 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 REPLAY_WORKLOAD.

Exemple de réexécution sur une instance Autonomous Database d'une charge globale capturée à partir d'une base de données sur site :

BEGIN 
   DBMS_CLOUD_ADMIN.REPLAY_WORKLOAD(
      location_uri    => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o',
      credential_name => 'CRED_TEST',   
      synchronization => TRUE,
      process_capture => TRUE);    
END;
/

Cette commande télécharge les fichiers de capture contenus dans l'emplacement Object Storage indiqué dans le paramètre location_uri et réexécute la capture de charge globale à partir des fichiers de capture. La réexécution génère et télécharge les rapports de réexécution et de référentiel AWR vers l'emplacement Object Storage indiqué dans le paramètre location_uri.

Dans cet exemple, namespace-string est l'espace de noms de stockage d'objet Oracle Cloud Infrastructure et bucketname est le nom du bucket. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

Pour plus d'informations sur le téléchargement de fichiers vers Object Storage, reportez-vous à Téléchargement de fichiers vers le bucket de banque d'objets Oracle Cloud Infrastructure.

Pour plus d'informations sur Object Storage, reportez-vous à Accès à Oracle Cloud Infrastructure Object Storage et création d'un bucket.

Le paramètre credential_name indique les informations d'identification permettant d'accéder au bucket de stockage d'objet. Les informations d'identification que vous fournissez doivent disposer des privilèges d'écriture dans le bucket Object Storage. Les privilèges d'écriture sont requis pour télécharger le rapport de réexécution vers le bucket.

Si vous ne spécifiez pas de valeur credential_name, DEFAULT_CREDENTIAL est utilisé.

Vous n'avez pas besoin de créer d'informations d'identification pour accéder à Oracle Cloud Infrastructure Object Storage si vous activez les informations d'identification de principal de ressource. Pour plus d'informations, reportez-vous à Utilisation du principal de ressource pour accéder aux ressources Oracle Cloud Infrastructure.

Le paramètre synchronization indique la méthode de synchronisation utilisée lors de la réexécution de la charge globale. La valeur TRUE indique que la synchronisation est basée sur un numéro SCN.

Le paramètre process_capture indique si vous devez indiquer la valeur process_capture. La valeur TRUE indique que la réexécution inclut process_capture.

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

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

Vous pouvez vous abonner à l'événement Informations com.oraclecloud.databaseservice.autonomous.database.information pour être informé des événements WorkloadReplayBegin et WorkloadReplayEnd. Ces événements fournissent des informations sur :

• Début et fin de REPLAY_WORKLOAD.

• Champ replayDownloadURL contenant l'URL de demande pré-authentifiée permettant d'accéder aux rapports dans la banque d'objets. L'URL de demande pré-authentifiée est valide pendant 7 jours à compter de la date de génération.

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

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

Vous pouvez interroger les vues DBA_CAPTURE_REPLAY_STATUS et DBA_CAPTURE_REPLAY_HISTORY pour vérifier le statut de réexécution de la charge globale.

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

Autonomous Database permet de provisionner une instance ou de créer un clone actualisable avec l'option de niveau de patch Anticipé. Sur les instances exécutées au niveau de patch Anticipé, Autonomous Database applique les patches de maintenance à venir une semaine avant l'application des patches aux bases de données de production (bases de données provisionnées au niveau de patch Régulier). A l'aide de la fonctionnalité WORKLOAD_AUTO_REPLAY, vous pouvez vous assurer qu'un patch à venir est testé par rapport à votre charge globale avant que le patch ne soit mis en production. Cela vous permet de vérifier que le patch corrige un problème connu ou n'introduit pas de problème affectant votre charge globale.

Pour trouver des informations sur les captures et les rediffusions, abonnez-vous aux événements Information. Les événements d'information fournissent une notification pour la capture de charge globale et les événements de réponse. Ils incluent une URL de demande pré-authentifiée dans laquelle vous pouvez télécharger le fichier de capture et le rapport de réexécution. Pour plus d'informations, reportez-vous à (Facultatif) Abonnement aux événements d'information à notifier des détails de capture et de réexécution.

Lorsque WORKLOAD_AUTO_REPLAY est activé, la base de données source capture une charge globale en l'exécutant pendant un nombre de minutes spécifié. Par défaut, la capture de charge globale démarre lorsque vous activez WORKLOAD_AUTO_REPLAY (vous pouvez éventuellement utiliser des paramètres pour définir le jour et l'heure de début de la capture). Ensuite, Autonomous Database vérifie le statut d'application de patches sur la base de données cible. Une fois le patch hebdomadaire à venir appliqué, Autonomous Database réexécute la charge globale sur la base de données cible. Ce cycle de capture-lecture se poursuit automatiquement chaque semaine, Autonomous Database capturant la charge globale sur la base de données source, attendant que le patch à venir soit appliqué et réexécutant la charge globale sur le clone actualisable.

Pour activer WORKLOAD_AUTO_REPLAY, procédez comme suit :

• La base de données source doit utiliser le niveau de patch Normal.

• La base de données cible doit utiliser le niveau de patch Anticipé.

• La base de données cible doit être un clone actualisable de la base de données source et doit être créée avant d'activer WORKLOAD_AUTO_REPLAY.

• Une base de données source peut activer WORKLOAD_AUTO_REPLAY pour un seul clone actualisable (vous pouvez activer cette fonctionnalité pour un seul clone actualisable, même si vous créez plusieurs clones actualisables à partir de la même base de données source).

• Une fois que vous avez activé WORKLOAD_AUTO_REPLAY, le cycle de capture-lecture se poursuit chaque semaine. Autonomous Database exécute une capture sur la base de données source, puis réexécute la charge globale sur la base de données cible, jusqu'à ce que vous désactiviez WORKLOAD_AUTO_REPLAY.

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

Autonomous Database applique automatiquement des patches à votre base de données. Oracle fournit un objectif de niveau de service de zéro régression dans votre base de données de production en raison de ces patches. Pour plus d'informations, voir Objectif de niveau de service à progression zéro.

Cet exemple active WORKLOAD_AUTO_REPLAY sur la base de données Autonomous Database source et sur la base de données clone actualisable cible indiquée. Avec WORKLOAD_AUTO_REPLAY activé, chaque semaine, Autonomous Database exécute une capture sur la base de données source et réexécute la charge globale sur la base de données cible, jusqu'à ce que vous désactiviez WORKLOAD_AUTO_REPLAY.

Pour trouver des informations sur les captures et les rediffusions, abonnez-vous aux événements Information. Les événements d'information fournissent une notification pour la capture de charge globale et les événements de réponse. Ils incluent une URL de demande pré-authentifiée dans laquelle vous pouvez télécharger le fichier de capture et le rapport de réexécution. Pour plus d'informations, reportez-vous à (Facultatif) Abonnement aux événements d'information à notifier des détails de capture et de réexécution.

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

Exécutez DBMS_CLOUD_ADMIN.DISABLE_FEATURE pour désactiver la réexécution automatique de la charge globale. Exemples :

BEGIN 
DBMS_CLOUD_ADMIN.DISABLE_FEATURE(
    feature_name => 'WORKLOAD_AUTO_REPLAY');   
END;
/

Vous devez être connecté en tant qu'utilisateur ADMIN ou disposer des privilèges DBMS_CLOUD_ADMIN pour exécuter DBMS_CLOUD_ADMIN.DISABLE_FEATURE.

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