零基础OceanBase数据库入门（6）：连接OB集群

前面我们已经完成了单机部署、查看集群、创建租户、数据库、用户，但所有操作的起点都是先连上集群。

OceanBase是多租户架构，sys租户是集群的 “管理员租户”，负责管理整个集群、所有租户与资源，是运维与排查的核心入口。本篇结合官方demo与文档学习3种最常用的sys租户连接方式。

一、sys租户是什么

sys租户是OceanBase集群默认自带的系统租户（租户ID=1），兼容MySQL模式，核心作用：

• 管理集群、节点、Zone、资源池
• 查看、创建、删除所有用户租户
• 查询集群全局视图与状态信息
• 默认管理员账号：root@sys

重点：连接普通租户用用户名@租户名，连接sys租户固定用root@sys。

二、连接前必备信息

先准备好如下关键参数，所有连接方式通用：

• OBServer IP：单机版默认127.0.0.1
• 端口：直连默认2881（部署时可自定义）
• 账号：root@sys
• 密码：部署时设置的密码（新集群初始可为空）
• 白名单：客户端IP已在租户白名单内（ob_tcp_invited_nodes）OceanBase

三、连接方式

1. OBClient连接（官方推荐）

obclient是OceanBase专属客户端，兼容性最好，优先用它。

1.1 标准连接命令

# 安全写法（不直接写密码，交互输入）
obclient -h127.0.0.1 -P2881 -uroot@sys -D oceanbase -A -c

1.2 完整带密码写法（仅测试用）

obclient -h127.0.0.1 -P2881 -uroot@sys -p'你的密码' -Doceanbase -A

1.3 参数说明

• -h: OBServer节点IP
• -P: 连接端口（默认2881）
• -u: 账号，固定格式：用户名@租户名
• -p: 密码（建议交互输入，更安全）
• -D: 默认进入oceanbase系统库
• -A: 不预加载统计信息，连接更快
• -c: 不忽略SQL注释（Hint不受影响）

2. MySQL客户端连接（兼容原生）

OceanBase MySQL租户原生兼容MySQL客户端（5.7/8.0均可），命令几乎一样，只需把obclient换成mysql。

[admin@vbox ~]$ obclient -h127.0.0.1 -P2883 -uroot@proxysys -p'2SHxhHAtHc' -Doceanbase -A 
Welcome to the OceanBase.  Commands end with ; or \g.
Your OceanBase connection id is 1287389193
Server version: 5.6.25

Copyright (c) 2000, 2018, OceanBase and/or its affiliates. All rights reserved.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

obclient(root@proxysys@proxysys)[oceanbase]> exit
Bye
[admin@vbox ~]$ mysql -h127.0.0.1 -P2883 -uroot@proxysys -p -Doceanbase -A 
Enter password: 
Welcome to the MariaDB monitor.  Commands end with ; or \g.
Your MySQL connection id is 1287389194
Server version: 5.6.25

Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

MySQL [oceanbase]> 

连接成功后会显示MySQL风格提示符，用法与OBClient完全一致。

3. ODC图形化连接（可视化管理）

OceanBase Developer Center（ODC）是官方图形化工具，适合新手及日常管理。

3.1 新建连接步骤

web界面如下：

登录 ODC

客户端如下图：

登录ODC→个人连接→新建连接

• 连接模式：MySQL
• 主机IP：127.0.0.1
• 端口：2881
• 集群名：单机版默认myoceanbase（可show parameters like 'cluster';查询）
• 租户名：sys
• 数据库账号：root
• 密码：部署时设置的密码
• 默认数据库：oceanbase

点击测试连接→保存

执行查询如下：

3.2 关键提醒

ODC中sys租户仅用于集群、租户管理，不建议存放业务数据

导入导出等功能建议配置root@sys账号以提升效率

四、高频避坑指南

• 账号格式错误:直连必须写root@sys，不要加集群名（如root@sys#myoceanbase），会直接报错。
• 端口错误: 直连默认2881，不是2883（OBProxy端口）。
• 密码/白名单问题:报错Access denied时可以先检查密码、白名单ob_tcp_invited_nodes；本地连接可设置白名单%放开权限OceanBase
• 客户端无法连接：检查防火墙、安全组是否放行2881端口，确认observer进程正常运行

五、连接成功后能干什么（sys 租户专属）

sys租户登录后，可执行集群核心管理操作：

-- 查看集群所有租户
SELECT TENANT_ID,TENANT_NAME,TENANT_TYPE,COMPATIBILITY_MODE FROM DBA_OB_TENANTS;

-- 查看集群名称
SHOW PARAMETERS LIKE 'cluster';

-- 查看集群节点信息
SELECT * FROM DBA_OB_SERVERS;

六、小结

本篇我们掌握了OceanBase sys租户的3种连接方式，核心记住两点：

• 账号格式：直连固定为root@sys，不加集群名
• 首选工具：日常运维用OBClient，可视化管理用ODC
• 安全规范：密码交互输入，生产不使用%放开所有IP

连接sys租户是集群管理的第一步，下一篇我们将学习sys租户常用运维命令，快速掌握集群状态查看、租户管理等核心技能。