Effectuer une trace SQL sur une base de données Autonomous AI

Affiche les étapes de configuration de la fonction de trace SQL sur la base de données Autonomous AI.

1. Créez un bucket pour stocker les fichiers trace dans le stockage d'objet cloud.

   Pour enregistrer les fichiers de trace SQL, le bucket peut se trouver dans n'importe quelle banque d'objets cloud prise en charge par Autonomous AI Database.

   Par exemple, pour créer un bucket dans Oracle Cloud Infrastructure Object Storage, procédez comme suit :

   1. Ouvrez la console Oracle Cloud Infrastructure.
   2. Sélectionnez Stockage dans le menu.
   3. Sous Stockage, sélectionnez Object Storage et Archive Storage.
   4. Cliquez sur Créer un bucket.
   5. Sur la page Créer un bucket, entrez le nom du bucket et cliquez sur Créer.

   Si vous utilisez Oracle Cloud Infrastructure Object Storage, notez que les fichiers de trace SQL ne sont pris en charge qu'avec les buckets créés dans le niveau de stockage standard. Veillez à choisir Standard en tant que niveau de stockage lors de la création du bucket. Pour plus d'informations sur le niveau Object Storage standard, reportez-vous à Présentation d'Object Storage.

2. Créez des informations d'identification pour votre compte Cloud Object Storage à l'aide de DBMS_CLOUD.CREATE_CREDENTIAL.

   Par exemple :

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DEF_CRED_NAME',
       username => 'adb_user@example.com', 
       password => 'password'
   );
   END;
   /

   Pour Oracle Cloud Infrastructure, username est votre nom utilisateur Oracle Cloud Infrastructure. password est votre jeton d'authentification Oracle Cloud Infrastructure. Pour plus d'informations, reportez-vous à Utilisation des jetons d'authentification.

   Pour plus de détails sur les paramètres et leurs valeurs, reportez-vous à Procédure CREATE_CREDENTIAL, en fonction du stockage d'objet cloud.

3. Définissez des paramètres d'initialisation pour indiquer l'URL Cloud Object Storage d'un bucket pour les fichiers trace SQL et pour indiquer les informations d'identification permettant d'accéder à Cloud Object Storage.
   1. Définissez la propriété de base de données DEFAULT_LOGGING_BUCKET pour indiquer le bucket de journalisation sur Cloud Object Storage.

      Par exemple, si vous créez le bucket avec Oracle Cloud Infrastructure Object Storage :

      SET DEFINE OFF;
      ALTER DATABASE PROPERTY SET 
         DEFAULT_LOGGING_BUCKET = 'https://objectstorage.us-ashburn-1.oraclecloud.com/n/namespace-string/b/bucket_name/o/';

      Où namespace-string est l'espace de noms Oracle Cloud Infrastructure Object Storage et bucket_name est le nom du bucket que vous avez créé précédemment. Pour plus d'informations, reportez-vous à Présentation des espaces de noms Object Storage.

      Pour obtenir la liste des régions, reportez-vous à Régions et domaines de disponibilité.

      La banque d'objets cloud que vous utilisez pour les fichiers de trace SQL peut être n'importe quelle banque d'objets cloud prise en charge par Autonomous AI Database.

   2. Définissez la propriété de base de données DEFAULT_CREDENTIAL sur les informations d'identification que vous avez créées à l'étape 2.

      Vous devez inclure le nom du schéma avec les informations d'identification. Dans cet exemple, le schéma est "ADMIN".

      Par exemple :

      ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME';

Affiche les étapes permettant d'activer la fonction de trace SQL pour la session de base de données.

1. (Facultatif) Définissez un identificateur client pour l'application. Cette étape est facultative mais recommandée. La fonction de trace SQL utilise l'identificateur client comme composant du nom du fichier trace lorsque ce dernier est écrit dans la banque d'objets cloud.

   Par exemple :

   BEGIN
     DBMS_SESSION.SET_IDENTIFIER('sqlt_test');
   END;
   /

2. (Facultatif) Définissez un nom de module pour l'application. Cette étape est facultative mais recommandée. La fonction de trace SQL utilise le nom du module comme composant du nom du fichier trace lorsque ce dernier est écrit dans la banque d'objets cloud.

   Par exemple :

   BEGIN
     DBMS_APPLICATION_INFO.SET_MODULE('modname', null);
   END;
   /

3. Activez l'utilitaire SQL Trace.

   ALTER SESSION SET SQL_TRACE = TRUE;

4. Exécutez votre charge globale.

   Cette étape consiste à exécuter l'ensemble de l'application ou des parties spécifiques de l'application. Lorsque vous exécutez la charge globale dans la session de base de données, les données de trace SQL sont collectées.

5. Désactivez la fonction de trace SQL.

   Lorsque vous désactivez la fonction de trace SQL, les données collectées pour la session sont écrites dans une table de la session et dans un fichier trace du bucket que vous configurez lorsque vous configurez la fonction de trace SQL. Pour plus de détails, reportez-vous à Désactivation de la fonction de trace SQL sur la base de données Autonomous AI.

Affiche les étapes de désactivation de la fonction de trace SQL sur la base de données Autonomous AI.

1. Désactivez l'utilitaire SQL Trace.

   ALTER SESSION SET SQL_TRACE = FALSE;

2. (Facultatif) Si nécessaire pour votre environnement, vous pouvez réinitialiser la propriété de base de données DEFAULT_LOGGING_BUCKET afin d'effacer la valeur du bucket de journalisation sur Cloud Object Storage.

   Par exemple :

   ALTER DATABASE PROPERTY SET DEFAULT_LOGGING_BUCKET = '';

Décrit le nom des fichiers de sortie pour les fichiers trace SQL et affiche les commandes permettant d'utiliser TKPROF pour organiser et afficher les données des fichiers trace.

sqltrace/sqlt_test/modname/sqltrace_5415_56432.trc

1. Copiez le fichier trace de la banque d'objets vers votre système local.
2. Accédez au répertoire dans lequel le fichier trace est enregistré.
3. Exécutez l'utilitaire TKPROF à partir de l'invite du système d'exploitation à l'aide de la syntaxe suivante :

   tkprof filename1 filename2 [waits=yes|no] [sort=option] [print=n]
       [aggregate=yes|no] [insert=filename3] [sys=yes|no] [table=schema.table]
       [explain=user/password] [record=filename4] [width=n]
   

   Les fichiers d'entrée et de sortie sont les seuls arguments requis.

4. Pour afficher l'aide en ligne, appelez TKPROF sans arguments.

Lorsque vous activez la fonction de trace SQL, les mêmes informations de trace enregistrées dans le fichier trace de la banque d'objets cloud sont disponibles dans la vue SESSION_CLOUD_TRACE de la session dans laquelle la fonction de trace a été activée.

DESC SESSION_CLOUD_TRACE

Name       Null? Type
---------- ----- ------------------------------
ROW_NUMBER       NUMBER
TRACE            VARCHAR2(32767)

SELECT trace FROM SESSION_CLOUD_TRACE ORDER BY row_number;