Interroger les journaux d'audit SQL d'une instance - - Centre de documentation Alibaba Cloud

Avant d'appeler cette opération, assurez-vous que l'instance exécute l'un des moteurs de base de données suivants :

MySQL
SQL Server
PostgreSQL

Remarque

Vous pouvez appeler cette opération jusqu'à 1 000 fois par minute et par compte. Les appels initiés via votre compte Alibaba Cloud et les utilisateurs RAM de ce compte sont comptabilisés.
Cette opération ne permet pas d'interroger les journaux générés par l'édition d'essai de SQL Explorer pour une instance ApsaraDB RDS for MySQL.
Lorsque vous appelez cette opération et définissez le paramètre Form sur File pour générer un fichier d'audit, le fichier contient au maximum un million d'entrées de journal et vous ne pouvez pas filtrer les entrées par mot-clé.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeSQLLogRecords	Opération à effectuer. Définissez la valeur sur DescribeSQLLogRecords.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxxx	Jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer la valeur, mais vous devez vous assurer que le jeton généré est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	ID de l'instance.
SQLId	Long	No	25623548	ID unique de l'instruction SQL.
QueryKeywords	String	No	table_name	Mot-clé utilisé pour la requête. Lorsque vous appelez cette opération et définissez le paramètre Form sur File pour générer un fichier d'audit, vous ne pouvez pas filtrer les entrées de journal par mot-clé. Vous pouvez spécifier jusqu'à 10 mots-clés. Les mots-clés utilisent un opérateur logique AND. Séparez les mots-clés par des espaces. Si un nom de champ dans l'instruction SQL spécifiée est entouré d'accent grave (`) et que vous souhaitez utiliser le nom de champ comme mot-clé, vous devez saisir les accents graves (`) avec le nom de champ. Par exemple, si le nom de champ est `id`, vous devez saisir `id` plutôt que id. Remarque Après avoir saisi un mot-clé, le système fait correspondre le mot-clé en fonction des paramètres Database, User et QueryKeywords. Les paramètres utilisent un opérateur logique OR.
StartTime	String	Yes	2011-06-01T15:00:00Z	Début de la plage de temps à interroger. Vous pouvez interroger les journaux générés au cours des 30 derniers jours. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC.
Database	String	No	Database	Nom de la base de données. Vous ne pouvez saisir qu'un seul nom de base de données. Si vous spécifiez ce paramètre, cette opération renvoie uniquement les journaux générés pour la base de données indiquée. Si vous ne spécifiez pas ce paramètre, cette opération renvoie les journaux générés pour toutes les bases de données de l'instance.
User	String	No	user	Nom d'utilisateur du compte. Vous ne pouvez saisir qu'un seul nom d'utilisateur. Si vous spécifiez ce paramètre, cette opération renvoie uniquement les journaux générés pour le compte indiqué. Si vous ne spécifiez pas ce paramètre, cette opération renvoie les journaux générés pour tous les comptes de l'instance.
Form	String	No	Stream	Indique s'il faut générer un fichier de journal d'audit SQL ou renvoyer des entrées de journal d'audit SQL. Valeurs valides : File : Si vous définissez ce paramètre sur File, cette opération génère un fichier de journal d'audit SQL et renvoie uniquement les paramètres de réponse communs. Après avoir appelé cette opération, vous devez appeler l'opération DescribeSQLLogFiles pour obtenir l'URL de téléchargement du fichier de journal d'audit SQL. Stream : Si vous définissez ce paramètre sur Stream, cette opération renvoie des entrées de journal d'audit SQL. Il s'agit de la valeur par défaut. Remarque Si vous définissez ce paramètre sur File, seules les instances ApsaraDB RDS for MySQL utilisant des SSD locaux et les instances ApsaraDB RDS for SQL Server sont prises en charge, et un maximum d'un million d'entrées de journal sont renvoyées.
EndTime	String	Yes	2011-06-11T15:00:00Z	Fin de la plage de temps à interroger. L'heure de fin doit être postérieure à l'heure de début. L'intervalle entre l'heure de début et l'heure de fin doit être inférieur à 30 jours. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC.
PageSize	Integer	No	30	Nombre d'entrées à renvoyer par page. Valeurs valides : 30 à 100. Valeur par défaut : 30.
PageNumber	Integer	No	1	Numéro de la page à renvoyer. Valeurs valides : tout entier positif non nul. Valeur par défaut : 1.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	08A3B71B-FE08-4B03-974F-CC7EA6DB1828	ID de la requête.
PageNumber	Integer	1	Numéro de la page renvoyée.
PageRecordCount	Integer	30	Nombre d'entrées de journal d'audit SQL sur la page actuelle.
TotalRecordCount	Long	100	Nombre total d'enregistrements renvoyés.
Items	Array of SQLRecord		Tableau contenant les détails de chaque entrée de journal d'audit SQL.
SQLRecord
HostAddress	String	192.168.0.121	Adresse IP du client connecté à l'instance.
SQLText	String	update test.zxb set id=0 limit 1	Instruction SQL exécutée dans la requête.
ReturnRowCounts	Long	30	Nombre d'entrées de journal d'audit SQL renvoyées.
DBName	String	testDB	Nom de la base de données.
ExecuteTime	String	2011-06-11T15:00:23Z	Heure d'exécution de l'instruction SQL. L'heure suit le format yyyy-MM-dd T HH:mm:ss Z. L'heure est affichée en UTC.
ThreadID	String	1025865428	ID du thread.
TotalExecutionTimes	Long	600	Durée d'exécution de l'instruction SQL. Unité : microsecondes.
AccountName	String	accounttest	Nom d'utilisateur du compte enregistré dans l'entrée de journal d'audit SQL.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=DescribeSQLLogRecords
&DBInstanceId=rm-uf6wjk5xxxxxx
&StartTime=2011-06-01T15:00:00Z
&EndTime=2011-06-11T15:00:00Z
&<Common request parameters>

Exemples de réponses réussies

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeSQLLogRecordsResponse>
	<PageNumber>1</PageNumber>
	<TotalRecordCounts>1</TotalRecordCounts>
	<ItemsCounts>1</ItemsCounts>
	<SQLItems>
		<SQLItem>
			<DBName>test</DBName>
			<AccountName>accounttest</AccountName>
			<HostAddress>192.168.0.121</HostAddress>
			<SQLText>update test.zxb set id=0 limit 1</SQLText>
			<TotalExecutionTimes>12</TotalExecutionTimes>
			<ReturnRowCounts>34</ReturnRowCounts>
			<ExecuteTime>2011-06-11T15:00:23Z</ExecuteTime>
		</SQLItem>
	</SQLItems>
	<RequestId>08A3B71B-FE08-4B03-974F-CC7EA6DB1828</RequestId>
</DescribeSQLLogRecordsResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageNumber" : 1,
  "TotalRecordCounts" : 1,
  "ItemsCounts" : 1,
  "SQLItems" : {
    "SQLItem" : [ {
      "DBName" : "test",
      "AccountName" : "accounttest",
      "HostAddress" : "192.168.0.121",
      "SQLText" : "update test.zxb set id=0 limit 1",
      "TotalExecutionTimes" : 12,
      "ReturnRowCounts" : 34,
      "ExecuteTime" : "2011-06-11T15:00:23Z"
    } ]
  },
  "RequestId" : "08A3B71B-FE08-4B03-974F-CC7EA6DB1828"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.