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.
Si vous avez activé DAS Enterprise Edition V3, la fonctionnalité Search est renommée Audit.
Prérequis
L'instance de base de données que vous souhaitez gérer est connectée à DAS et son statut est Normal Access.
SQL Explorer and Audit est activé pour l'instance. Pour plus d'informations, consultez la section Activer SQL Explorer and Audit.
-
Pour utiliser la fonctionnalité Search en tant qu'utilisateur RAM, vous devez attacher la stratégie AliyunHDMReadOnlyWithSQLLogArchiveAccess. Pour plus d'informations, consultez la section Autoriser un utilisateur RAM à l'aide d'une stratégie système.
RemarqueVous pouvez également utiliser une stratégie personnalisée pour accorder à un utilisateur RAM les autorisations nécessaires à l'utilisation de la fonctionnalité Search, y compris l'exportation des données. Pour plus d'informations, consultez la section Utiliser une stratégie personnalisée pour autoriser un utilisateur RAM à utiliser les fonctionnalités de recherche et d'exportation de SQL Explorer and Audit.
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.
RemarquePour 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
Connectez-vous à la console DAS.
Dans le volet de navigation de gauche, cliquez sur .
Repérez l'instance cible et cliquez sur son identifiant pour ouvrir la page des détails de l'instance.
-
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.
RemarqueUn 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.
RemarqueCliquez sur Enable Advanced Query pour saisir davantage d'informations et restreindre la portée de la recherche.
-
-
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.
ImportantVous 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.
-
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. Ouvrez le fichier CSV exporté à l'aide d'Excel.
Sélectionnez la colonne de données que vous souhaitez fractionner. Dans la barre d'outils Excel, choisissez Data > Text to Columns.
Dans l'assistant Convert Text to Columns Wizard, sous Original data type, sélectionnez Delimited et cliquez sur Next.
-
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.
Dans la section Column data format, sélectionnez Regular et cliquez sur Complete.
FAQ
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.
|