---
title: "管控命令概述 - OceanBase Binlog 服务 V4.3.3 | OceanBase 文档中心"
description: 管控命令概述 Binlog 服务提供管控命令，可以通过 SQL 实现对 Binlog 任务、实例和日志文件等的管理。 Binlog 服务的管控命令需登录 Binlog Server 执行，主要包含如下几类： 节点管理：管理 Binlog 节点，用于查询当前 Binlog 服务的节点信息，或查询指定租户的主 Binlo…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*qvvxQ5-hqEoAAAAAAAAAAAAADiGDAQ/original) OceanBase Binlog 服务V 4.3.3

# 管控命令概述

更新时间：2026-06-03 09:25:03

[编辑](https://github.com/oceanbase/oblogproxy-doc/edit/V4.3.3/zh-CN/500.binlog-command/100.binlog-command.md)  

Binlog 服务提供管控命令，可以通过 SQL 实现对 Binlog 任务、实例和日志文件等的管理。

Binlog 服务的管控命令需登录 Binlog Server 执行，主要包含如下几类：

- 节点管理：管理 Binlog 节点，用于查询当前 Binlog 服务的节点信息，或查询指定租户的主 Binlog 实例所在的节点信息。
 - 任务管理：管理 Binlog 任务，包含创建、查询、修改、释放操作。租户与 Binlog 任务是一对一的关系，一个租户中只能创建一个 Binlog 任务。
 - 实例管理：管理 Binlog 实例，包含创建、查询、修改、启停和切主操作。Binlog 任务与 Binlog 实例为一对多的关系，一个 Binlog 任务中可以创建多个 Binlog 实例。
 - 会话管理：管理 Binlog 会话，包含查询和删除会话。
 - 文件管理：目前仅支持 `PURGE BINARY LOGS` 命令，用于清除 Binlog 文件。

Binlog 服务管控命令介绍如下，具体使用可访问链接查看对应文档

| 类别 | 命令 | 说明 |
| --- | --- | --- |
| [节点管理](https://www.oceanbase.com/docs/common-oblogproxy-doc-1000000004391658) | SHOW NODES | 用于查询当前 Binlog 服务的节点。 |
| SHOW BINLOG SERVER | 用于查询指定租户的主 Binlog 实例所在的节点信息，若无可用主 Binlog 实例将返回 ERR 包。 |
| [任务管理](https://www.oceanbase.com/docs/common-oblogproxy-doc-1000000004391655) | CREATE BINLOG | 用于为指定的 OceanBase 数据库租户开通 Binlog，Binlog Server 将异步地创建 N 个 Binlog 实例。 |
| SHOW BINLOG STATUS | 用于查询 Binlog 任务中主 Binlog 实例的 Binlog 文件和资源指标数据，若主 Binlog 实例不可用则返回空集。 |
| ALTER BINLOG | 用于修改指定租户下所有 Binlog 实例的参数配置，对后续新增的 Binlog 实例也生效。 |
| DROP BINLOG | 用于关闭指定租户的所有 Binlog 实例，同时删除已生成的存量 Binlog 文件。 |
| [实例管理](https://www.oceanbase.com/docs/common-oblogproxy-doc-1000000004391654) | 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 文件也会被同步清理。 |
| [会话管理](https://www.oceanbase.com/docs/common-oblogproxy-doc-1000000004391657) | SHOW [FULL] PROCESSLIST | 用于查询 Binlog 实例上的连接会话。 |
| KILL | 用于终止 Binlog 实例上已有连接的会话。 |
| [文件管理](https://www.oceanbase.com/docs/common-oblogproxy-doc-1000000004391653) | PURGE BINARY LOGS | 用于删除指定 Binlog 文件。 |

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
