---
title: "v$ob_cluster | OceanBase 文档中心"
description: v$ob_cluster 功能 v$ob_cluster 用于展示当前集群的基本信息。 字段说明 字段名称 类型 是否可以为 NULL 描述 cluster_id bigint(20) NO 集群唯一 ID。 cluster_name varchar(4096) NO 集群名。 created timestamp(6…
---
切换语言

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

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

# v$ob_cluster

更新时间：2024-04-07 14:30:34

## 功能

`v$ob_cluster` 用于展示当前集群的基本信息。

## 字段说明

| **字段名称** | **类型** | **是否可以为 NULL** | **描述** |
| --- | --- | --- | --- |
| cluster_id | bigint(20) | NO | 集群唯一 ID。 |
| cluster_name | varchar(4096) | NO | 集群名。 |
| created | timestamp(6) | NO | 集群创建时间。 |
| cluster_role | varchar(4096) | NO | 集群角色： - `PRIMARY`：表示主集群 - `PHYSICAL STANDBY`：表示备集群 |
| cluster_status | varchar(4096) | NO | 集群状态： - `VALID`：表示有效状态 - `DISABLED`：表示禁止同步数据状态 - `DISABLED WITH READ ONLY`：表示主集群以只读模式启动的状态 默认是 `VALID` 状态，用户可以在主集群上禁止某一个备集群同步。在 Failover 过程中，新主集群会自动设置其他备集群为 `DISABLED` 状态，默认禁止其他备集群与新主集群同步数据。 |
| switchover# | bigint(20) | NO | 一次 Switchover 或 Failover 操作的唯一标识。 |
| switchover_status | varchar(4096) | NO | Switchover 状态： - `NOT ALLOWED`： - 主集群上显示 `NOT ALLOWED` 表示当前集群不能 Switchover 成备集群。 - 备集群上显示 `NOT ALLOWED` 表示当前集群不能 Switchover 成主集群。 - `TO PRIMARY`：只在备集群上显示，表示当前集群可以切换成主集群。 - `TO STANDBY`：只在主集群上显示，表示当前集群可以切换成备集群。 - `SWITCHOVER SWITCHING`：主集群 Switchover 成备集群的中间状态。处于该状态的集群不能提供写服务，内部停写日志。 - `FAILOVER FLASHBACK`：备集群 Failover 成主集群的中间状态，集群正在回滚数据到一致状态。处于该状态的集群不能提供写服务，用户可以持续重试 Failover 命令，直到成功 Failover 成主集群。 - `FAILOVER CLEANUP`：备集群 Failover 成主集群的中间状态，集群正在做最后的清理工作，包括清理无效的 Freeze info、删除无效的 Schema 等。处于该状态的集群提供写服务，但是不能执行 DDL 操作。 - `DISCONNECT`：备集群解耦的中间状态。表示集群正在执行解耦，包括更改集群名、解除与原主集群的主备关系等操作。处于该状态的集群不能提供写服务，用户可以持续重试解耦命令，直到解耦成功。 |
| switchover_info | varchar(4096) | NO | 展示 Switchover 相关信息，`SWITCHOVER_STATUS` 的详细说明如下： - `NOT ALLOWED`：表示为何不允许切换。 - `TO STANDBY`：表示有哪些备集群可以切为主集群。 - 其他状态时，该列值为空。 具体取值示例： - `CHECK PRIMARY CLUSTER SERVER STATUS`：表示需要校验主集群的 Server 状态，可能存在 Server 不在线的情况。 - `CHECK STADNBY CLUSTER SERVER STATUS`：表示需要校验备集群的 Server 状态，可能存在 Server 不在线的情况。 - `CHECK PRIMARY CLUSTER REBALANCE TASK STATUS`：表示需要校验主集群的负载均衡任务是否完成。 - `CHECK STANDBY CLUSTER REBALANCE TASK STATUS`：表示需要校验备集群的负载均衡任务是否完成。 - `CHECK MERGE STATUS`：表示检查合并状态是否出现 ERROR。 - `NONE SYNCED STANDBY CLUSTER`：没有同步的备集群存在，主集群不能切换为备集群。 - `SYNCED STANDBY CLUSTERS: cluster1, cluster2` ：表示处于同步状态的备集群列表。 - `CHECK SYS SCHEMA SYNC STATUS` ：表示需要校验备集群中系统租户的 Schema 是否同步完成。 - `CHECK USER SCHEMA SYNC STATUS`：表示需要校验备集群中普通租户的 Schema 是否同步完成。 - `CHECK FREEZE INFO SYNC STATUS`：表示需要校验备集群冻结信息是否同步完成。 - `CHECK ENOUG REPLICA`：表示需要检查备集群的副本个数是否齐全。 - `CHECK REDO LOG SYNC STATUS`：表示需要校验备集群的 REDO 日志是否同步完成。 - `CAN NOT ACCESS CLUSTERS: cluster1, cluster2`：表示某些集群不能访问，需要校验这些备集群的状态。 - `NO CLUSTER IN SWITCHING`：表示没有集群处于`SWITCHING`状态，不能执行`switchover to primary`。该信息是备集群处于`NOT ALLOW`状态时可能展示的信息。 - `INNER ERROR`：表示发生内部错误，需要查看集群日志排查问题，日志关键字为`SWITCHOVER_STATUS`。 - `PRIMARY CLUSTER HAS REPLICA IN RESTORE` ：表示当前主集群有部分副本没有创建完成，不允许执行角色切换。需要用户主动删除这部分副本之后才能继续进行角色切换。 - `STANDBY CLUSTER HAS REPLICA IN RESTORE`：表示当前备集群有部分副本没有创建完成，不允许执行角色切换。需要等副本创建完成才能继续进行角色切换。 - `PRIMARY CLUSTER DOING BACKUP`：表示主集群正在执行备份，不允许执行角色切换，因为切换为备集群后不再支持备份，要求用户先停止备份任务。 - `CHECK OTHER PRIMARY CLUSTE`：表示存在其他主集群，不允许执行角色切换，防止集群出现双主。 |
| current_scn | bigint(20) | NO | 集群连续已回放的最大快照版本。 |
| standby_became_primary_scn | bigint(20) | NO | 备集群强制切换为主集群的快照版本。    **注意**    执行 Switchover 不会影响该值，该值在所有正常接入的主集群和备集群上均可查询到，并且主备集群保持一致。 |
| primary_cluster_id | bigint(20) | YES | - 对于备集群，该字段表示它认为的主集群的唯一 ID；如果没有主集群，则该值为 NULL。 - 对于主集群，该字段为 NULL。      **注意**      此处与 Oracle 数据库不兼容，Oracle 数据库中，如果主集群之前曾经是备集群，则该字段为上一个主集群的信息；如果主集群没有成为过备集群，则该字段为 NULL。 |
| protection_mode | varchar(4096) | NO | 集群的保护模式。 |
| protection_level | varchar(4096) | NO | 集群的保护级别。 |
| redo_transport_options | varchar(4096) | NO | 集群接收日志的传输模式。 |

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