API参考 - API参考 - 日志管理 -DescribeSQLLogRecords

查询实例的SQL审计日志可以通过调用DescribeSQLLogRecords接口来实现，但请注意，此接口已停止维护，推荐使用查询DAS企业版热存储数据明细功能。尽管如此，以下是根据您的请求参数和返回参数需求整理的指南：

请求参数说明

1. Action (String, 必填): 系统规定参数，固定取值为 DescribeSQLLogRecords。
2. DBInstanceId (String, 必填): 指定要查询的RDS实例名。
3. Database (String, 可选): 数据库名称，默认查询所有数据库。
4. User (String, 可选): 用户名称，默认查询所有用户。
5. Form (String, 可选): 定义响应形式，取值：
   • File: 触发审计日志文件生成，需进一步调用DescribeSQLLogFiles获取下载地址。注意：仅支持MySQL（本地盘）和SQL Server实例，且限制记录数为100万条。
   • Stream(默认): 直接返回SQL记录列表。
6. QueryKeywords (String, 可选): 关键字查询，多个关键字以空格分隔，不超过10个关键字，逻辑关系为and。
7. StartTime (String, 必填): 查询起始时间，格式为yyyy-MM-dd'T'HH:mm:ssZ（UTC时间），可查询最近7天内的数据。
8. EndTime (String, 必填): 查询结束时间，格式同上，需大于开始时间且间隔不超过7天。
9. PageSize (Integer, 可选): 每页记录数，默认30，可选值为30、50、100。
10. PageNumber (Integer, 可选): 页码，默认值为1。

返回参数结构

• TotalRecordCount (Integer): 总记录数。
• PageNumber (Integer): 当前页码。
• PageRecordCount (Integer): 本页SQL日志明细数量。
• Items: 包含以下字段的SQL审计日志列表：
  • DBName (String): 数据库名称。
  • AccountName (String): 执行操作的账号名称。
  • HostAddress (String): 客户端IP地址。
  • SQLText (String): SQL语句内容。
  • TotalExecutionTimes (Long): SQL执行消耗时间，单位微秒。
  • ReturnRowCounts (Long): SQL执行返回的记录数。
  • ThreadID (String): 线程ID。
  • ExecuteTime (String): SQL执行时间，格式为yyyy-MM-dd'T'HH:mm:ssZ。

示例请求URL

https://rds.aliyuncs.com/?Action=DescribeSQLLogRecords&DBInstanceId=<您的实例ID>&StartTime=2023-04-01T00:00:00Z&EndTime=2023-04-07T23:59:59Z&PageSize=50

请替换 <您的实例ID> 为实际的实例标识，并根据需要调整其他参数。

重要提醒： 单用户每分钟调用次数上限为1000次，请合理安排查询频率。此外，该接口已被标记为停止维护，建议转向使用DAS企业版相关功能进行SQL洞察与审计日志查询。