导出全量SQL - ExportAllQueryLogs

功能介绍

全量SQL开关打开后，一次性导出指定时间范围内的全量SQL数据，支持分页滚动获取。该功能仅支持付费实例。

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
das:clouddba:fullSqlExport
list
instance
-
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
das:clouddba:fullSqlExport	list	instance	-	-	-

URI

GET /v3/{project_id}/instances/{instance_id}/sql-statements

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：租户在某一Region下的项目ID。获取方法请参见获取项目ID。约束限制：不涉及。取值范围：只能由英文字母、数字组成，且长度为32个字符。默认取值：不涉及。
instance_id	是	String	参数解释：实例ID。标识实例的唯一标识。约束限制：不涉及。取值范围：只能由英文字母、数字组成，且长度为32个字符。默认取值：不涉及。

表2 Query参数
参数	是否必选	参数类型	描述
start_at	是	Long	参数解释：开始时间。约束限制： Unix timestamp，单位：毫秒。取值范围： [0, 2^31-1]，实际取决于查询。默认取值：不涉及。
end_at	是	Long	参数解释：结束时间。约束限制： Unix timestamp，单位：毫秒。取值范围： [0, 2^31-1]，实际取决于查询。默认取值：不涉及。
limit	是	Integer	参数解释：每页记录数。约束限制：不涉及。取值范围： [0, 2000]，实际取决于查询。默认取值：不涉及。
marker	否	String	参数解释：指定一个标识符。获取第一页时不用赋值，获取下一页时取上页查询结果的返回值。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
datastore_type	是	String	参数解释：数据库类型。约束限制：不涉及取值范围： MySQL TaurusDB 默认取值：不涉及。

请求参数

无。

响应参数

状态码： 200

表3 响应Body参数
参数	参数类型	描述
statements	Array of FullSql objects	参数解释：全量SQL集合。当集合为空时，说明SQL已全部导出。取值范围：不涉及。
next_marker	String	参数解释：获取下一页所需的标识符。marker仅在3分钟内有效。取值范围：不涉及。

表4 FullSql
参数	参数类型	描述
sql	String	参数解释： SQL语句。取值范围：不涉及。
operate_type	String	参数解释：操作类型。取值范围： insert：插入 delete：删除 update：更新 select：查询 show：显示 create：创建 drop：丢弃/删除 alter：修改 set：设置 replace：替换 use：使用 start：开始事务 commit：提交事务 rollback：回滚事务 truncate：截断 begin：开始事务 call：调用存储过程
status	String	参数解释：状态。取值范围： 0：SQL执行成功 1：SQL执行失败
error_no	String	参数解释：错误码。取值范围：不涉及。
database	String	参数解释：数据库名。取值范围：不涉及。
client	String	参数解释：客户端。取值范围：不涉及。
thread_id	String	参数解释：线程ID。取值范围：不涉及。
user	String	参数解释：用户。取值范围：不涉及。
execute_at	Long	参数解释：执行开始时间（Unix timestamp），单位：毫秒。取值范围： [0, 2^31-1]，实际取决于查询。
query_time	Double	参数解释：执行耗时（毫秒）。取值范围：不涉及。
lock_time	Double	参数解释：锁等待耗时（毫秒）。取值范围：不涉及。
rows_examined	Long	参数解释：扫描行数。取值范围： [0, 2^31-1]，实际取决于查询。
rows_sent	Long	参数解释：返回行数。取值范围： [0, 2^31-1]，实际取决于查询。
rows_affected	Long	参数解释：更新行数。取值范围： [0, 2^31-1]，实际取决于查询。

请求示例

导出全量SQL数据。

GET https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/instances/da304cd5bbb944de828759bc7be3d3fein01/sql-statements?start_at=1611975464337&end_at=1611979064337&limit=10&marker=DXF1ZXJ5QW5kRmV0Y2gBAAAAAAAQH8YWSEFfM3FyOXZRNzJQOTVLNHNBOTQ2UQ==&datastore_type=MySQL

响应示例

状态码： 200

导出全量SQL返回体。

{
  "statements" : [ {
    "sql" : "SELECT 1",
    "operate_type" : "select",
    "status" : "success",
    "error_no" : "",
    "database" : "",
    "thread_id" : "11481954",
    "client" : "100.79.3.154",
    "user" : "root",
    "execute_at" : 1612403000100,
    "query_time" : 0,
    "lock_time" : 0,
    "rows_examined" : 0,
    "rows_sent" : 1,
    "rows_affected" : 0
  } ],
  "next_marker" : "DXF1ZXJ5QW5kRmV0Y2gBAAAAAAASG3cWcHVpdktBU1lTbjJMM2tmYXYxZ09nUQ=="
}