首批通过分布式安全可靠测评,为关键业务系统打造
管控命令概述
更新时间:2026-06-03 09:25:03
Binlog 服务提供管控命令,可以通过 SQL 实现对 Binlog 任务、实例和日志文件等的管理。
Binlog 服务的管控命令需登录 Binlog Server 执行,主要包含如下几类:
- 节点管理:管理 Binlog 节点,用于查询当前 Binlog 服务的节点信息,或查询指定租户的主 Binlog 实例所在的节点信息。
- 任务管理:管理 Binlog 任务,包含创建、查询、修改、释放操作。租户与 Binlog 任务是一对一的关系,一个租户中只能创建一个 Binlog 任务。
- 实例管理:管理 Binlog 实例,包含创建、查询、修改、启停和切主操作。Binlog 任务与 Binlog 实例为一对多的关系,一个 Binlog 任务中可以创建多个 Binlog 实例。
- 会话管理:管理 Binlog 会话,包含查询和删除会话。
- 文件管理:目前仅支持
PURGE BINARY LOGS命令,用于清除 Binlog 文件。
Binlog 服务管控命令介绍如下,具体使用可访问链接查看对应文档
| 类别 | 命令 | 说明 |
|---|---|---|
| 节点管理 | SHOW NODES | 用于查询当前 Binlog 服务的节点。 |
| SHOW BINLOG SERVER | 用于查询指定租户的主 Binlog 实例所在的节点信息,若无可用主 Binlog 实例将返回 ERR 包。 | |
| 任务管理 | CREATE BINLOG | 用于为指定的 OceanBase 数据库租户开通 Binlog,Binlog Server 将异步地创建 N 个 Binlog 实例。 |
| SHOW BINLOG STATUS | 用于查询 Binlog 任务中主 Binlog 实例的 Binlog 文件和资源指标数据,若主 Binlog 实例不可用则返回空集。 | |
| ALTER BINLOG | 用于修改指定租户下所有 Binlog 实例的参数配置,对后续新增的 Binlog 实例也生效。 | |
| DROP BINLOG | 用于关闭指定租户的所有 Binlog 实例,同时删除已生成的存量 Binlog 文件。 | |
| 实例管理 | CREATE BINLOG INSTANCE | 用于为已开通 Binlog 的租户添加新的 Binlog 实例。 |
| SHOW BINLOG INSTANCES | 用于查询 Binlog 实例相关信息,存在相关记录将返回一到多条记录,若无符合条件记录则返回空集。 | |
| ALTER BINLOG INSTANCE | 用于修改指定 Binlog 实例的参数配置。 | |
| STOP BINLOG INSTANCE | 用于停止指定 Binlog 实例。 | |
| START BINLOG INSTANCE | 用于启动指定 Binlog 实例。 | |
| SWITCH MASTER INSTANCE | 用于手动切换指定租户的主 Binlog 实例。 | |
| DROP BINLOG INSTANCE | 用于删除指定的 Binlog 实例,Binlog 文件也会被同步清理。 | |
| 会话管理 | SHOW [FULL] PROCESSLIST | 用于查询 Binlog 实例上的连接会话。 |
| KILL | 用于终止 Binlog 实例上已有连接的会话。 | |
| 文件管理 | PURGE BINARY LOGS | 用于删除指定 Binlog 文件。 |