---
title: 如何连接到 OB 4.x 集群中的 Meta 租户-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于如何连接到 OB 4.x 集群中的 Meta 租户相关的常见问题和使用技巧，帮助您快速解决如何连接到 OB 4.x 集群中的 Meta 租户的难题。
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

划线反馈

# 如何连接到 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 租户的方法

#### 前置条件

1. 必须先通过 sys 租户直连到存在该租户资源的任一 OBServer 节点，不能通过 OBProxy 连接到 Meta 租户。
 2. Meta 租户不可直接登录，只能通过 `ALTER SYSTEM CHANGE TENANT` 切换。

#### 方式一：通过 tenant_id 切换

```sql
-- 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;

```

输出结果：

```plain
+---------------------+
| Current_tenant_name |
+---------------------+
| META$1004           |
+---------------------+

```

> **注意**：`tenant_id` 填写的是 Meta 租户的租户 ID（Meta 租户的 ID 一定是奇数），系统会自动切换到对应的 Meta 租户（`META$<租户ID>`）。

#### 方式二：通过 Meta 租户名切换

```sql
-- 1. 以 sys 租户登录
obclient -h <observer_host> -P 2881 -u root@sys -p <password>

-- 2. 直接指定 Meta 租户名切换
ALTER SYSTEM CHANGE TENANT META$1002;

```

输出结果：

```plain
+---------------------+
| Current_tenant_name |
+---------------------+
| META$1002           |
+---------------------+

```

#### 方式三：切换回 sys 租户

```sql
-- 切换回系统租户
ALTER SYSTEM CHANGE TENANT sys;

-- 或使用租户 ID（sys 租户 ID 固定为 1）
ALTER SYSTEM CHANGE TENANT tenant_id=1;

-- 验证
SHOW TENANT;

```

输出结果：

```plain
+---------------------+
| Current_tenant_name |
+---------------------+
| sys                 |
+---------------------+

```

### 使用场景

| 场景 | 说明 |
| --- | --- |
| 内部表查询 | 部分内部元数据表存储在 Meta 租户下 |
| 故障排查 | 诊断租户级别的元数据问题 |
| 运维调试 | 检查租户内部的副本、日志流状态 |
| 深度诊断 | 排查主备同步、备份恢复相关的元数据异常 |

### 注意事项

| 事项 | 说明 |
| --- | --- |
| 连接入口 | 必须通过 sys 租户直连到有该业务租户资源的 OBServer |
| 租户 ID | `CHANGE TENANT tenant_id=xxx` 中的 xxx 是 Meta 租户 ID，不是业务租户 ID |
| 生命周期 | Meta 租户随用户租户创建而创建，随用户租户删除而删除 |
| 资源分配 | Meta 租户没有独立的 Unit，资源从用户租户配额中扣除 |
| 只读操作 | Meta 租户主要用于查询诊断，不建议直接修改内部表 |

### 相关视图

sys 租户下查询 Meta 租户信息：

```sql
-- 查看租户列表（包含 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 租户下查询内部表：

```sql
-- 切换到 Meta 租户后
USE oceanbase;

-- 查看日志流状态
SELECT * FROM __all_virtual_log_stat;

```

## 适用版本

OceanBase V4.1.0(oceanbase-4.1.0.0-100001122023040322) 及之后版本。

Previous

[与服务器的连接断开，错误代码 ERROR 2013](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000217848)

Next

[select a(a'') 断连接的问题](https://www.oceanbase.com/knowledge-base/oceanbase-database-20000036893) ![有帮助](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) 咨询热线