Documentation Oracle Cloud Infrastructure

Exécution de la fonction de trace SQL sur Autonomous Database

Utilisez la trace SQL pour identifier la source d'une charge globale de base de données excessive, telle qu'une instruction SQL à charge élevée dans votre application.

Thème parent : Surveillance et gestion des performances

Configuration de la trace SQL sur Autonomous Database

Présente les étapes de configuration de la fonction de trace SQL sur Autonomous Database.

Remarque

Si vous activez la trace SQL, les performances de l'application pour la session peuvent être dégradées pendant que la collecte de trace est activée. Cette incidence négative sur les performances est attendue en raison du temps système lié à la collecte et à l'enregistrement des données de trace.

Afin de configurer votre base de données pour la trace SQL, procédez comme suit :

  1. Créez un bucket pour stocker les fichiers trace dans le stockage Cloud Object Storage.

    Pour enregistrer les fichiers de la fonction de trace SQL, le bucket peut se trouver dans n'importe quel stockage d'objet cloud pris en charge par Autonomous 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, saisissez le nom du bucket et cliquez sur Créer.

    Si vous utilisez Oracle Cloud Infrastructure Object Storage, les fichiers de la fonction de trace SQL sont uniquement pris en charge avec les buckets créés dans le niveau de stockage standard. Veillez à sélectionner Standard comme 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 de stockage d'objet cloud à l'aide de DBMS_CLOUD.CREATE_CREDENTIAL.

    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 d'informations sur les paramètres et leurs valeurs, en fonction du stockage d'objet cloud, reportez-vous à Procédure CREATE_CREDENTIAL.

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

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

      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é.

      Le stockage d'objet cloud que vous utilisez pour les fichiers de la fonction de trace SQL peut se trouver dans n'importe quel stockage d'objet cloud pris en charge par Autonomous Database.

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

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

      Exemple :

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

Activation de la trace SQL sur Autonomous Database

Présente les étapes d'activation de la trace SQL pour la session de base de données.

Remarque

Si vous activez la trace SQL, les performances de l'application pour la session peuvent être dégradées pendant que la collecte de trace est activée. Cette incidence négative sur les performances est attendue en raison du temps système lié à la collecte et à l'enregistrement des données de trace.

Avant d'activer la trace SQL, vous devez configurer la base de données pour enregistrer les fichiers trace SQL. Pour plus d'informations, reportez-vous à Configuration de la surveillance SQL sur Autonomous Database.

Pour activer la trace SQL, procédez comme suit :

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

    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 trace SQL utilise le nom de module comme composant du nom de fichier trace lorsque ce dernier est écrit dans le stockage d'objet cloud.

    Exemple :

    BEGIN
  DBMS_APPLICATION_INFO.SET_MODULE('modname', null);
END;
/
  3. Activez la fonction de trace SQL.
    ALTER SESSION SET SQL_TRACE = TRUE;
  4. Exécutez la charge globale.

    Cette étape implique l'exécution de l'intégralité de l'application ou de certaines parties spécifiques de l'application. Pendant que vous exécutez la charge globale dans la session de base de données, les données de la recherche SQL sont collectées.

  5. Désactiver la fonction de trace SQL.

    Lorsque vous désactivez la 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 lors de la configuration de la trace SQL. Pour plus d'informations, reportez-vous à Désactivation de la fonction de surveillance SQL sur Autonomous Database.

Désactivation de la fonction de trace SQL sur Autonomous Database

Présente les étapes de désactivation de la fonction de trace SQL sur Autonomous Database.

Pour désactiver la trace SQL, procédez comme suit :

  1. Désactivez la fonction de trace SQL.
    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 le stockage d'objet cloud.

    Exemple :

    ALTER DATABASE PROPERTY SET DEFAULT_LOGGING_BUCKET = '';

Lorsque vous désactivez la fonction de suivi SQL, les données de suivi collectées pendant l'exécution de la session avec la fonction de suivi activée sont copiées dans une table et envoyées vers un fichier trace sur le stockage d'objet cloud. Vous pouvez afficher les données de trace de deux manières :

Visualisation du fichier trace enregistré dans le stockage d'objet cloud sur Autonomous Database

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

Les données du fichier trace SQL permettent d'analyser les performances des applications sur Autonomous Database. Lorsque vous désactivez la trace SQL dans la session de base de données, les données sont écrites dans le bucket de stockage d'objet cloud configuré avec DEFAULT_LOGGING_BUCKET.

La fonction de trace SQL écrit les données de trace collectées dans la session dans le stockage d'objet cloud au format suivant :

default_logging_bucket/sqltrace/clientID/moduleName/sqltrace_numID1_numID2.trc

Les composants du nom de fichier sont les suivants :

  • default_logging_bucket : valeur de la propriété de base de données DEFAULT_LOGGING_BUCKET. Pour plus d'informations, reportez-vous à Configuration de la surveillance SQL sur Autonomous Database.

  • clientID : identificateur client. Pour plus d'informations, reportez-vous à activation de la fonction de surveillance SQL sur Autonomous Database.

  • moduleName : nom du module. Pour plus d'informations, reportez-vous à activation de la fonction de surveillance SQL sur Autonomous Database.

  • numID1_numID2 : deux identifiants fournis par la fonction de trace SQL. Les valeurs numériques numID1 et numID2 distinguent de manière unique chaque nom de fichier trace d'autres sessions utilisant la fonction de trace et créant des fichiers trace dans le même bucket de stockage d'objet cloud.

    Lorsque le service de base de données prend en charge le parallèle et qu'une session exécute une requête parallèle, la fonction de trace SQL peut produire plusieurs fichiers trace avec différentes valeurs numID1 et numID2.

Remarque

Lorsque la trace SQL est activée et désactivée plusieurs fois dans la même session, chaque itération de trace génère un fichier trace distinct dans le stockage d'objet cloud. Pour ne pas écraser les traces précédentes générées dans la session, les fichiers générés par la suite suivent la même convention de nom et un suffixe numérique est ajouté au nom de fichier trace. Ce suffixe numérique commence par le nombre 1 et est ensuite augmenté de 1 pour chaque itération de suivi.

Par exemple, voici un exemple de nom de fichier trace généré lorsque vous définissez l'identificateur client sur sql_test et le nom de module sur modname : 

sqltrace/sqlt_test/modname/sqltrace_5415_56432.trc

Vous pouvez exécuter TKPROF pour convertir le fichier trace en fichier de sortie lisible.

  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.

Pour plus d'informations sur l'utilisation de l'utilitaire TKPROF, reportez-vous à Tools for End-to-End Application Tracing dans le guide de réglage SQL Oracle Database.

Visualisation des données de trace dans la vue SESSION_CLOUD_TRACE sur Autonomous Database

Lorsque vous activez la trace SQL, les informations de trace enregistrées dans le fichier trace dans le stockage d'objet cloud sont également disponibles dans la vue SESSION_CLOUD_TRACE de la session où la trace a été activée.

Pendant que vous êtes encore dans la session de base de données, vous pouvez visualiser les données de la recherche SQL dans la vue SESSION_CLOUD_TRACE. La vue SESSION_CLOUD_TRACE comprend les colonnes ROW_NUMBER et TRACE : 

DESC SESSION_CLOUD_TRACE

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

La colonne ROW_NUMBER indique l'ordre des données de trace trouvées dans la colonne TRACE. Chaque ligne de la sortie de trace écrite dans un fichier trace devient une ligne de la table et est disponible dans la colonne TRACE.

Après avoir désactivé la fonction de trace SQL pour la session, vous pouvez exécuter des requêtes sur la vue SESSION_CLOUD_TRACE.

Exemple :

SELECT trace FROM SESSION_CLOUD_TRACE ORDER BY row_number;

Les données de SESSION_CLOUD_TRACE persistent pendant toute la durée de la session. Une fois la session déconnectée ou fermée, les données ne sont plus disponibles.

Si la trace SQL est activée et désactivée plusieurs fois dans la même session, SESSION_CLOUD_TRACE affiche les données de trace de toutes les itérations cumulées. Par conséquent, la réactivation de la fonction de trace dans une session après sa désactivation n'enlève pas les données de trace générées par l'itération précédente.