Tous les produits
Search
Centre de documentation

Database Autonomy Service:Audit

Dernière mise à jour :Aug 10, 2026

Database Autonomy Service (DAS) met à votre disposition la fonctionnalité Search (Audit), qui vous permet d'interroger et d'exporter diverses informations relatives aux instructions SQL. Cette rubrique décrit l'utilisation de la fonctionnalité Search dans SQL Explorer and Audit.

Important

Si vous avez activé DAS Enterprise Edition V3, la fonctionnalité Search est renommée Audit.

Prérequis

Remarques d'utilisation

  • Dans le volet Logs, un statut Status défini sur Successful pour une instruction SQL indique uniquement que celle-ci a été exécutée avec succès, sans générer d'exception. Par exemple, lors d'un rollback de transaction, si une instruction SQL individuelle au sein de la transaction s'exécute correctement, son Status dans le volet Logs affichera Successful.

  • Pour les instances ApsaraDB RDS for MySQL et PolarDB for MySQL, les connexions peuvent être réutilisées grâce au connection pooling. Par conséquent, les adresses IP et les ports affichés dans le volet Logs peuvent ne pas correspondre aux adresses IP et aux ports réels du client. Pour plus d'informations, consultez la documentation relative au Connection pooling pour ApsaraDB RDS for MySQL ou au Connection pooling pour PolarDB for MySQL.

  • Un paramètre détermine la longueur maximale des instructions SQL enregistrées. Les instructions dépassant cette limite sont tronquées. Étant donné qu'un préfixe est ajouté lors de la collecte et du traitement des données, la longueur réelle d'une instruction SQL enregistrée est légèrement inférieure à la valeur configurée pour ce paramètre.

    Remarque
    • Pour les versions 5.6 et 5.7 d'ApsaraDB RDS for MySQL et d'PolarDB for MySQL, la longueur d'enregistrement est contrôlée par le paramètre loose_rds_audit_max_sql_size.

    • Pour la version 8.0 d'ApsaraDB RDS for MySQL et d'PolarDB for MySQL, la longueur d'enregistrement est contrôlée par le paramètre loose_rds_audit_log_event_buffer_size.

  • Lorsque vous cliquez sur Enable Advanced Query, vous avez la possibilité d'effectuer des requêtes par Transaction ID si votre instance de base de données répond aux exigences de version suivantes :

    • Pour une instance ApsaraDB RDS for MySQL, la version majeure doit être 8.0 et la version mineure doit être 20210311 ou ultérieure. Avant d'exécuter une requête, vous devez définir le paramètre loose_rds_audit_log_version sur MYSQL_V3. Pour plus d'informations, consultez la section Aperçu des paramètres d'ApsaraDB RDS for MySQL 8.0.

    • Pour un cluster PolarDB for MySQL, la version doit être 8.0.1.1.15 ou ultérieure.

Procédure

  1. Connectez-vous à la console DAS.

  2. Dans le volet de navigation de gauche, cliquez sur Intelligent O&M Center > Instance Monitoring .

  3. Repérez l'instance cible et cliquez sur son identifiant pour ouvrir la page des détails de l'instance.

  4. Dans le volet de navigation de gauche, cliquez sur SQL Explorer and Audit. Sur la page qui s'affiche, cliquez sur Search et configurez les paramètres suivants.

    Si vous avez activé DAS Enterprise Edition V3, cliquez sur Audit sur la page qui s'affiche.

    Paramètre

    Description

    Time Range

    Sélectionnez une plage de temps pour la requête en fonction de vos besoins métier.

    Les requêtes couvrant plus de 24 heures peuvent être lentes ou expirer en raison du volume important de données capturées par SQL Explorer and Audit.

    Remarque
    • Vous ne pouvez interroger que les données générées pendant la période de rétention après l'activation de Enterprise Edition de DAS.

    • Pour interroger des enregistrements sur une plage de temps plus étendue, exportez les journaux pour une analyse hors ligne. La fonction d'exportation s'exécute de manière asynchrone et convient aux grands volumes de données.

    • Lorsque SQL Explorer and Audit utilise le stockage chaud et froid, la plage de temps maximale pour une seule requête ou exportation est de 24 heures.

    Keyword

    Vous pouvez combiner plusieurs mots-clés dans une recherche. Séparez les mots-clés par un espace. La recherche floue n'est pas prise en charge.

    Remarque

    Un mot-clé doit comporter au moins quatre caractères.

    User

    Vous pouvez spécifier plusieurs noms d'utilisateur, par exemple user1 user2 user3.

    Database

    Vous pouvez spécifier plusieurs noms de bases de données, par exemple DB1 DB2 DB3.

    Operation Type

    Sélectionnez un ou plusieurs types d'opération à interroger.

    Remarque

    Cliquez sur Enable Advanced Query pour saisir davantage d'informations et restreindre la portée de la recherche.

  5. Cliquez sur Query pour afficher les détails des instructions SQL dans le volet Logs.

    Cliquez sur Export, sélectionnez les champs requis sous Exported Fields, puis cliquez sur Export SQL Records. Vous pouvez définir la Export Time Range afin d'exporter des enregistrements sur une plage de temps plus large.

    Pour SQL Explorer and Audit utilisant le stockage chaud et froid, sélectionnez un CSV Separator qui n'est pas présent dans les journaux SQL lors de l'exportation des données. Pour plus d'informations, consultez la section Configurer et ouvrir un fichier CSV exporté afin de garantir que les données s'affichent dans des colonnes distinctes.

    Important
    • Vous pouvez exporter jusqu'à 10 millions d'entrées de données sur une période de sept jours dans une seule tâche.

    • Pour SQL Explorer and Audit utilisant le stockage chaud et froid, le système crée une tâche lorsque vous interrogez ou exportez des données depuis le stockage froid. Vous pouvez consulter la progression et l'historique des tâches sur la page Task list.

    • Vous ne pouvez interroger ou exporter que les données générées après l'activation de la fonctionnalité audit logs.

    Vous pouvez filtrer les résultats par Plage de temps, Mot-clé, Utilisateur, Base de données et Type d'opération (SELECT, INSERT, UPDATE et DELETE). Vous pouvez également cliquer sur Enable Advanced Query pour définir des conditions supplémentaires. La section Logs comprend des colonnes telles que Instruction SQL, Base de données, ID de thread, Utilisateur, IP client, Opération, Statut, Latence (ms), Temps d'exécution, Lignes mises à jour et Lignes analysées.

Configurer et ouvrir un fichier CSV exporté

Si un délimiteur de données existe dans vos journaux SQL exportés, les colonnes risquent de se désaligner lorsque vous ouvrez le fichier CSV dans un outil tel que Microsoft Excel. Pour éviter ce problème, la fonctionnalité Search pour le stockage chaud et froid vous permet de sélectionner un CSV Separator lors de l'exportation. Cette section explique comment formater correctement le fichier pour un affichage en colonnes, en prenant Excel 2019 sur Windows comme exemple.

  1. Lors de la création d'une tâche d'exportation, sélectionnez un séparateur absent de vos journaux SQL, tel que $.

    Les séparateurs CSV disponibles sont |, $ et #. Si votre texte SQL contient des guillemets, choisissez l'un de ces séparateurs spéciaux pour éviter les conflits. Vous pouvez également modifier le Nom de la tâche. Une fois les paramètres définis, cliquez sur Soumettre la tâche.

  2. Ouvrez le fichier CSV exporté à l'aide d'Excel.

  3. Sélectionnez la colonne de données que vous souhaitez fractionner. Dans la barre d'outils Excel, choisissez Data > Text to Columns.

  4. Dans l'assistant Convert Text to Columns Wizard, sous Original data type, sélectionnez Delimited et cliquez sur Next.

  5. Dans la section Delimiters, cochez Others, saisissez $ dans le champ, puis cliquez sur Next.

    Un aperçu des colonnes s'affiche dans la section Data preview.

  6. Dans la section Column data format, sélectionnez Regular et cliquez sur Complete.

FAQ

Q : Pour les instances ApsaraDB RDS for MySQL et PolarDB for MySQL, pourquoi certaines requêtes SQL renvoient-elles des données mais affichent-elles 0 pour les lignes analysées dans la section Logs ?

R : Cela se produit si le paramètre query_cache_type est activé sur l'instance de base de données. Le nombre de lignes analysées dans la section Logs reflète le nombre de lignes analysées par le moteur InnoDB. Lorsque query_cache_type est activé, MySQL tente de mettre en cache les résultats des requêtes. Si une requête ultérieure correspond à une entrée du cache, le résultat est renvoyé directement depuis le cache sans accéder au moteur InnoDB. Par conséquent, des données sont renvoyées, mais le nombre de lignes analysées est égal à 0.

Q : Pourquoi ne puis-je pas trouver les instructions SQL ayant échoué pour mon instance ApsaraDB RDS for PostgreSQL ?

R : Pour les instances ApsaraDB RDS for PostgreSQL, les instructions SQL ayant échoué sont enregistrées dans les journaux d'erreurs de l'instance, et non dans les journaux d'audit. Pour interroger les journaux d'erreurs, consultez la section Afficher les journaux.

Q : Pourquoi le nom de la base de données dans la section Logs diffère-t-il de celui figurant dans l'instruction SQL ?

R : Le nom de la base de données affiché dans la section Logs est récupéré depuis la session, tandis que le nom de la base de données dans l'instruction SQL est spécifié par l'utilisateur. Ces noms peuvent différer dans des scénarios tels que les requêtes inter-bases de données ou le SQL dynamique, où l'entrée de l'utilisateur ou la conception de la requête détermine le nom de la base de données dans l'instruction.

Q : L'activation de SQL Explorer and Audit affecte-t-elle les performances de la base de données ? Quel est l'impact ?

R : Oui, mais l'impact est minime et presque imperceptible.

L'impact sur les ressources spécifiques est le suivant :

  • CPU et mémoire : La consommation est extrêmement faible et peut être ignorée.

  • Espace de stockage : La fonctionnalité stocke principalement des informations d'audit. Toutefois, DAS Enterprise Edition stocke ces données côté DAS, de sorte qu'elle ne consomme pas l'espace de stockage de votre instance de base de données.

  • Réseau : Aucun impact sur les performances réseau.

  • Performances du disque : Aucun impact. Les données d'audit sont écrites dans le stockage DAS, et non sur les disques de l'instance de base de données.

Référence API

Vous pouvez appeler les opérations API suivantes pour interroger les journaux SQL des instances ApsaraDB RDS for MySQL, ApsaraDB RDS for PostgreSQL et ApsaraDB RDS for SQL Server :

|
**API**
|
**Description**
| | --- | --- | |
[DescribeSQLLogRecords](t2252009.xdita#)
|
Interroge les journaux SQL Explorer and Audit pour une instance ApsaraDB RDS.
| |
[DescribeSQLLogFiles](t2252010.xdita#)
|
Récupère la liste des fichiers exportés depuis SQL Explorer and Audit.
|