基于湖库一体架构，统一管理结构化、半结构化与非结构化等多模态数据，一个系统承载事务处理、实时分析与 AI 工作负载。
划线反馈
如何连接到 OB 4.x 集群中的 Meta 租户
更新时间：2026-08-25 02:41
分享
适用版本：V4.0.x内容类型：TechNote
总结说明
本文介绍 OceanBase 4.x 版本中 Meta 租户的概念、连接方法、使用场景及注意事项。
详细说明
Meta 租户定义
Meta 租户是 OceanBase 4.x 版本集群内部自管理的租户，每创建一个用户租户会自动创建一个对应的 Meta 租户，其租户 ID = 对应用户租户的 ID（1002、1004、...）- 1，其生命周期与用户租户保持一致。
Meta 租户 vs. 用户租户 vs. 系统租户
| 租户类型 | 存储内容 | 主备同步 | 物理备份恢复 | 可登录 | Unit 分配 |
|---|---|---|---|---|---|
| 用户租户 | 用户数据（表、部分系统表） | 需要 | 需要 | 可登录 | 独立 Unit |
| Meta 租户 | 租户私有数据（配置、位置、副本、日志流状态等） | 不需要同步 | 不参与 | 不可直接登录 | 从用户租户资源中扣除 |
| 系统租户 (sys) | 集群私有数据（支撑集群运行） | 不需要同步 | 不参与 | 可登录 | 独立 Unit |
Meta 租户存储的数据
| 数据类型 | 说明 |
|---|---|
| 配置项 | 租户级别的配置参数 |
| 位置信息 | 数据分布与位置元数据 |
| 副本信息 | 副本状态与角色信息 |
| 日志流状态 | 日志流的运行状态 |
| 备份恢复信息 | 租户级别的备份恢复元数据 |
| 合并信息 | 每日合并的状态与进度 |
关键特性：Meta 租户的数据不需要跨库物理同步以及物理备份恢复，主备集群会各自创建自己的 Meta 租户，物理备份恢复出来的租户也会有自己的 Meta 租户。
连接 Meta 租户的方法
前置条件
- 必须先通过 sys 租户直连到存在该租户资源的任一 OBServer 节点，不能通过 OBProxy 连接到 Meta 租户。
- Meta 租户不可直接登录，只能通过
ALTER SYSTEM CHANGE TENANT切换。
方式一：通过 tenant_id 切换
-- 1. 以 sys 租户登录
obclient -h <observer_host> -P 2881 -u root@sys -p <password>
-- 2. 切换到 Meta 租户（tenant_id 填写 Meta 租户的租户 ID，Meta 租户的 ID 一定为奇数）
ALTER SYSTEM CHANGE TENANT tenant_id=1003;
-- 3. 验证当前租户
SHOW TENANT;
输出结果：
+---------------------+
| Current_tenant_name |
+---------------------+
| META$1004 |
+---------------------+
注意：
tenant_id填写的是 Meta 租户的租户 ID（Meta 租户的 ID 一定是奇数），系统会自动切换到对应的 Meta 租户（META$<租户ID>）。
方式二：通过 Meta 租户名切换
-- 1. 以 sys 租户登录
obclient -h <observer_host> -P 2881 -u root@sys -p <password>
-- 2. 直接指定 Meta 租户名切换
ALTER SYSTEM CHANGE TENANT META$1002;
-- 3. 验证当前租户
SHOW TENANT;
输出结果：
+---------------------+
| Current_tenant_name |
+---------------------+
| META$1002 |
+---------------------+
方式三：切换回 sys 租户
-- 切换回系统租户
ALTER SYSTEM CHANGE TENANT sys;
-- 或使用租户 ID（sys 租户 ID 固定为 1）
ALTER SYSTEM CHANGE TENANT tenant_id=1;
-- 验证
SHOW TENANT;
输出结果：
+---------------------+
| Current_tenant_name |
+---------------------+
| sys |
+---------------------+
使用场景
| 场景 | 说明 |
|---|---|
| 内部表查询 | 部分内部元数据表存储在 Meta 租户下 |
| 故障排查 | 诊断租户级别的元数据问题 |
| 运维调试 | 检查租户内部的副本、日志流状态 |
| 深度诊断 | 排查主备同步、备份恢复相关的元数据异常 |
注意事项
| 事项 | 说明 |
|---|---|
| 连接入口 | 必须通过 sys 租户直连到有该业务租户资源的 OBServer |
| 租户 ID | CHANGE TENANT tenant_id=xxx 中的 xxx 是 Meta 租户 ID，不是业务租户 ID |
| 生命周期 | Meta 租户随用户租户创建而创建，随用户租户删除而删除 |
| 资源分配 | Meta 租户没有独立的 Unit，资源从用户租户配额中扣除 |
| 只读操作 | Meta 租户主要用于查询诊断，不建议直接修改内部表 |
相关视图
sys 租户下查询 Meta 租户信息：
-- 查看租户列表（包含 sys 租户、Meta 租户和业务租户）
SELECT * FROM oceanbase.DBA_OB_TENANTS;
-- 查看资源规格信息
SELECT * FROM oceanbase.DBA_OB_UNIT_CONFIGS;
-- 查看租户资源池（包含 sys 租户和业务租户，不包含 Meta 租户）
SELECT * FROM oceanbase.DBA_OB_RESOURCE_POOLS;
Meta 租户下查询内部表：
-- 切换到 Meta 租户后
USE oceanbase;
-- 查看日志流状态
SELECT * FROM __all_virtual_log_stat;
适用版本
OceanBase V4.1.0(oceanbase-4.1.0.0-100001122023040322) 及之后版本。
