SERVER - OceanBase 数据库 V4.1.0 | OceanBase 文档中心

SERVER

更新时间：2023-07-28 10:45:58

描述

该语句维护系统中 OBServer 状态，控制 OBServer 的增、删、启、停等操作。

该语句仅支持在 sys 租户执行。

语法

alter_system_server_stmt:
    ALTER SYSTEM server_action SERVER ip_port_list [zone];

server_action:
      ADD
    | DELETE
    | CANCEL DELETE
    | START
    | STOP
    | FORCE STOP
    | ISOLATE

ip_port_list:
    ip_port [, ip_port ...]

参数解释

参数	描述
ip_port	指定 OBServer 的 IP 地址和端口。
zone	如果指定 Zone，将会对待维护 Server 执行 Zone 校验。
ADD	新增 OBServer。 `ADD` 会将 OBServer 加入到服务列表，只有服务列表中的 OBServer 才可以提供服务。
DELETE	删除 OBServer。 `DELETE` 操作会等待 OBServer 清空后，才会将其移出服务列表，该操作会引起 Unit 迁移。
CANCEL DELETE	取消删除 OBServer。
START	启动 OBServer。
STOP	停止 OBServer。 `STOP` 会检查停止后副本数是否满足多数派、等待 Clog 日志同步完成，并等待 Leader 副本切换到其他节点（即 Leader 改选）。
FORCE STOP	强制停止 OBServer。 `FORCE STOP` 会检查停止后副本数是否满足多数派，并等待 Leader 副本切换到其他节点（即 Leader 改选）。注意强制停止 OBServer 不是常规的运维操作，由于强制停止不会等待 Clog 日志同步完成，该操作并不安全，一般情况下不建议使用。
ISOLATE	隔离故障 OBServer，新的读写请求都不会路由到隔离的故障机器进程上。 `ISOLATE` 不会等待 Leader 副本切换到其他节点（即 Leader 改选）。

示例

向集群新增 OBServer xxx.xx.xxx.xx1。

obclient> ALTER SYSTEM ADD SERVER 'xxx.xx.xxx.xx1:xxxx' ZONE 'zone1';