---
title: "查看租户信息 | OceanBase 文档中心"
description: 查看租户信息 您可以通过 SQL 语句查看租户的信息。 通过视图查看租户信息 查看所有租户信息 sys 租户可以通过视图 oceanbase.DBA_OB_TENANTS 来查看集群中的租户信息，包括各租户的 ID、名称、Primary Zone 以及副本分布方式等。 使用 root 用户登录到数据库的 sys 租户…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.0.0 社区版

# 查看租户信息

更新时间：2026-06-21 11:35:30

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.0.0/zh-CN/500.administrator-guide/600.basic-database-management/400.manage-tenants-1/400.manage-tenants-2/100.view-tenant-information.md)  

您可以通过 SQL 语句查看租户的信息。

## 通过视图查看租户信息

### 查看所有租户信息

`sys` 租户可以通过视图 `oceanbase.DBA_OB_TENANTS` 来查看集群中的租户信息，包括各租户的 ID、名称、Primary Zone 以及副本分布方式等。

1. 使用 `root` 用户登录到数据库的 `sys` 租户。
 2. 执行以下语句，查看当前集群中的租户信息。

   示例如下：

   ```sql
   obclient> SELECT * FROM oceanbase.DBA_OB_TENANTS\G
   *************************** 1. row ***************************
            TENANT_ID: 1
          TENANT_NAME: sys
          TENANT_TYPE: SYS
          CREATE_TIME: 2022-06-17 11:29:55.853445
         PRIMARY_ZONE: RANDOM
             LOCALITY: FULL{1}@zone1
    PREVIOUS_LOCALITY: NULL
   COMPATIBILITY_MODE: MYSQL
               STATUS: TENANT_STATUS_NORMAL
        IN_RECYCLEBIN: NO
               LOCKED: NO
   *************************** 2. row ***************************
            TENANT_ID: 1001
          TENANT_NAME: META$1002
          TENANT_TYPE: META
          CREATE_TIME: 2022-06-17 11:55:14.355747
         PRIMARY_ZONE: zone1
             LOCALITY: FULL{1}@zone1
    PREVIOUS_LOCALITY: NULL
   COMPATIBILITY_MODE: MYSQL
               STATUS: TENANT_STATUS_NORMAL
        IN_RECYCLEBIN: NO
               LOCKED: NO
   2 rows in set

   ```

   > **说明**
   >
   >  
   >
   > 暂不支持普通租户查看视图 `oceanbase.DBA_OB_TENANTS` 。

   更多视图 `oceanbase.DBA_OB_TENANTS` 的字段说明信息请参见 [DBA_OB_TENANTS](https://www.oceanbase.com/docs/community-observer-cn-10000000000900769)。

### 查看当前租户信息

所有用户均可以查看当前租户的信息，包括租户名、租户 ID、租户状态等。

1. 用户登录到当前租户。
 2. 执行以下语句，查看当前租户信息。

      - 查看当前租户名。

       ```sql
       obclient> SHOW TENANT;
       +---------------------+
       | Current_tenant_name |
       +---------------------+
       | sys                 |
       +---------------------+
       1 row in set

       ```
      - 查看当前有效租户。

       ```sql
       obclient> SELECT effective_tenant();
       +--------------------+
       | effective_tenant() |
       +--------------------+
       | sys                |
       +--------------------+
       1 row in set

       ```
      - 查看当前租户的状态。

       ```sql
       obclient> SHOW TENANT STATUS;
       +--------+------------+
       | Tenant | Status     |
       +--------+------------+
       | sys    | read write |
       +--------+------------+
       1 row in set

       ```
      - 查看当前租户的 ID。

       ```sql
       obclient> SELECT effective_tenant_id();
       +-----------------------+
       | effective_tenant_id() |
       +-----------------------+
       |                     1 |
       +-----------------------+
       1 row in set

       ```

 上一篇 下一篇 ![有帮助](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) 咨询热线
