零基础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

三、连接方式

OBClient连接（官方推荐）

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

1.1 标准连接命令

nginx 复制代码

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

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

nginx 复制代码

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不受影响）

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

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

python 复制代码

[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 1287389193Server 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]> exitBye[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 1287389194Server 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完全一致。

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

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

3.1 新建连接步骤

web界面如下：

客户端如下图：

登录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租户登录后，可执行集群核心管理操作：

sql 复制代码

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

sql 复制代码

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

sql 复制代码

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

六、小结

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

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

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

往期回顾：

零基础OceanBase数据库入门：搭建你的第一个OceanBase数据库

零基础OceanBase数据库入门(2）：查看集群基本信息

零基础OceanBase数据库入门（3）：创建租户

零基础OceanBase数据库入门（4）：创建MySQL模式数据库

零基础OceanBase数据库入门（5）：MySQL模式用户创建与权限管理