文档首页/数据管理服务 DAS/API参考/API（公测中）/云DBA/查看binlog解析详情 - BinlogParseSearch
更新时间：2026-01-07 GMT+08:00
查看PDF
分享

查看binlog解析详情 - BinlogParseSearch

功能介绍

查看binlog解析详情。

授权信息

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

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    das:clouddba:listBinlog

    list

    instance

    -

    -

    -

URI

POST /v3/{project_id}/connections/{connection_id}/binlog-parse/search

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

租户在某一Region下的项目ID。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

connection_id

是

String

参数解释：

连接ID。用户使用数据库账号与数据库建立的连接ID（数据库用户ID由创建实例连接创建）。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字、中划线组成，且长度为36个字符的UUID。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

task_id

是

Long

参数解释：

解析任务ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

start_time

否

Long

参数解释：

开始时间（Unix timestamp），单位：毫秒。

约束限制：

不涉及。

取值范围：

[0, 2^31-1]，实际取决于查询。

默认取值：

不涉及。

end_time

否

Long

参数解释：

结束时间（Unix timestamp），单位：毫秒。

约束限制：

不涉及。

取值范围：

[0, 2^31-1]，实际取决于查询。

默认取值：

不涉及。

db_name

否

String

参数解释：

数据库名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

table_name

否

String

参数解释：

表名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

type_list

否

Array of Strings

参数解释：

SQL类型列表。

约束限制：

不涉及。

取值范围：

  • insert
  • update
  • delete
  • ddl

默认取值：

不涉及

cur_page

是

Integer

参数解释：

页码。

约束限制：

不涉及。

取值范围：

[0, 2^31-1]，实际取决于查询。

默认取值：

不涉及。

per_page

是

Integer

参数解释：

每页记录数。

约束限制：

不涉及。

取值范围：

[0, 100]，实际取决于查询。

默认取值：

不涉及。

column_list

否

Array of 表3 objects

参数解释：

筛选条件列表。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

表3 FilterColumn

参数

是否必选

参数类型

描述

column_name

否

String

参数解释：

筛选条件字段名。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

column_value

否

String

参数解释：

筛选条件值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

total

Integer

参数解释：

总数。

取值范围：

[0, 2^31-1]

event_list

Array of 表5 objects

参数解释：

binlog详情信息列表。

取值范围：

不涉及。

表5 EventRowsVo

参数

参数类型

描述

event_id

Long

参数解释：

事件ID。

取值范围：

不涉及。

file_name

String

参数解释：

文件名称。

取值范围：

不涉及。

position

Long

参数解释：

解析位置。

取值范围：

不涉及。

timestamp

Long

参数解释：

事件发生时间，单位毫秒。

取值范围：

不涉及。

db_name

String

参数解释：

变更的数据库名称。

取值范围：

不涉及。

table_name

String

参数解释：

变更的表名称。

取值范围：

不涉及。

sql_type

String

参数解释：

变更的SQL类型。

取值范围：

  • insert
  • update
  • delete
  • ddl

sql_statement

String

参数解释：

变更的SQL语句。

取值范围：

不涉及。

column_names

Array of Strings

参数解释：

变更的列名称列表。

取值范围：

不涉及。

primary_keys

Array of Strings

参数解释：

变更的主键列表。

取值范围：

不涉及。

affect_rows

Integer

参数解释：

变更影响的行数。

取值范围：

不涉及。

row_pairs

Array of 表6 objects

参数解释：

变更数据详情。

取值范围：

不涉及。

表6 RowPairDto

参数

参数类型

描述

before_row

JSONObject

参数解释：

变更前的行数据。

取值范围：

不涉及。

after_row

JSONObject

参数解释：

变更后的行数据。

取值范围：

不涉及。

请求示例

POST https://das.cn-north-1.myhuaweicloud.com/v3/054e292c9880d4992f02c0196d3ea468/connections/179e525e-0e9c-4dcc-9dd7-ee2f36121e23/binlog-parse/search 
 
{
  "cur_page": 1,
  "per_page": 10,
  "db_name": null,
  "table_name": null,
  "column_list": [],
  "type_list": ["insert", "update", "delete", "ddl"],
  "start_time": null,
  "end_time": null,
  "task_id": 1163
}

响应示例

状态码： 200

Success.

{
    "total": 2,
    "eventList": [
        {
            "event_id": 1,
            "file_name": "mysql-bin.045330",
            "position": 302,
            "timestamp": 1764127367000,
            "db_name": "cds",
            "table_name": "shopping",
            "sql_type": "ddl",
            "sql_statement": "CREATE TABLE shopping (\n\na int NOT NULL AUTO_INCREMENT,\n\nb int,\n\nc int,\n\nPRIMARY KEY (a),\n\nUNIQUE KEY u_k (b, c)\n\n)",
            "column_names": []
        },
        {
            "event_id": 2,
            "file_name": "mysql-bin.045330",
            "position": 750,
            "timestamp": 1764127374000,
            "db_name": "cds",
            "table_name": "shopping",
            "sql_type": "insert",
            "column_names": [
                "a",
                "b",
                "c"
            ],
            "primary_keys": [
                "a"
            ],
            "affect_rows": 3,
            "row_pairs": [
                {
                    "after_row": {
                        "a": 1,
                        "b": 1,
                        "c": 1
                    }
                },
                {
                    "after_row": {
                        "a": 2,
                        "b": 1,
                        "c": 5
                    }
                },
                {
                    "after_row": {
                        "a": 3,
                        "b": 1,
                        "c": 9
                    }
                }
            ]
        }
    ]
}

状态码

状态码

描述

200

Success.

400

Client error.

500

Server error.

错误码

请参见错误码。

父主题：云DBA

相关文档