---
title: "使用限制 | OceanBase 文档中心"
description: 使用限制 标识符长度限制 MySQL 模式 数据项 最大长度 集群名 128 字节 租户名 63 字节 用户名 64 字节 数据库名 128 字符 表名 64 字符 列名 128 字符 索引名 64 字符 视图名 64 字符 别名 255 字符 表组名 127 字节 分区名 64 字符 Oracle 模式 类型 最大…
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 3.2.3 企业版 LTS

# 使用限制

更新时间：2025-12-30 11:02:00

## 标识符长度限制

- MySQL 模式

  | **数据项** | **最大长度** |
  | --- | --- |
  | 集群名 | 128 字节 |
  | 租户名 | 63 字节 |
  | 用户名 | 64 字节 |
  | 数据库名 | 128 字符 |
  | 表名 | 64 字符 |
  | 列名 | 128 字符 |
  | 索引名 | 64 字符 |
  | 视图名 | 64 字符 |
  | 别名 | 255 字符 |
  | 表组名 | 127 字节 |
  | 分区名 | 64 字符 |
 - Oracle 模式

  | **类型** | **最大长度** |
  | --- | --- |
  | 集群名 | 128 字节 |
  | 租户名 | 63 字节 |
  | 用户名 | 64 字节 |
  | 表名 | 128 字节 |
  | 列名 | 128 字节 |
  | 索引名 | 128 字节 |
  | 视图名 | 128 字节 |
  | 别名 | 128 字节 |
  | 对象名 | 128 字节 |
  | 表组名 | 127 字节 |
  | 分区名 | 64 字符 |

## ODP(OceanBase Database Proxy) 最大连接数限制

| 类型 | 最大限制 |
| --- | --- |
| 单个 ODP 的连接数 | 由 ODP 的 `client_max_connections` 参数控制，默认为 8192。    **说明**   您可以通过增加 ODP 节点数或者修改 `client_max_connections` 配置项值的方式来增大集群的连接总数限制。 |

## 分区副本数限制

| 类型 | 最大限制 |
| --- | --- |
| 每个 OBServer 节点的分区副本数 | 500000 个    **说明**   每个 OBServer 节点的分区副本数与您所使用的机器配置有关，当机器配置不高时，建议每个 OBServer 节点的分区副本数不要超过 30000 个。 |

## 单个表的限制

| 类型 | 最大限制 |
| --- | --- |
| 行长度 | 1.5M 字节 |
| 行数 | 无限制 |
| 列数 | 4096 列 |
| 索引个数 | 128 个 |
| 单个索引总列数 | 64 列 |
| 索引长度 | 16K |
| 主键总列数 | 64 列 |
| 主键长度 | 16K |
| 分区个数 | - Oracle 模式：65536 个 - MySQL 模式：8192 个 |

## 单列的限制

| 类型 | 最大限制 |
| --- | --- |
| 索引单个列长度 | 16K |

## 字符串类型限制

- MySQL 模式

  | **类型** | **最大长度** |
  | --- | --- |
  | `CHAR` | 256 字节 |
  | `VARCHAR` | 262144 字节 |
  | `BINARY` | 256 字节 |
  | `VARBINARY` | 1048576 字节 |
  | `TINYBLOB` | 256 字节 |
  | `BLOB` | 65536 字节 |
  | `MEDIUMBLOB` | 16777216 字节 |
  | `LONGBLOB` | 50331648 字节 |
  | `TINYTEXT` | 256 字节 |
  | `TEXT` | 65536 字节 |
  | `MEDIUMTEXT` | 16777216 字节 |
  | `LONGTEXT` | 50331648 字节 |
 - Oracle 模式

  | **类型** | **最大长度** |
  | --- | --- |
  | `CHAR` | 2000 字节 |
  | `VARCHAR` | 32767 字节 |
  | `VARCHAR2` | 32767 字节 |
  | `NCHAR` | 2000 字节 |
  | `NVARCHAR2` | 32767 字节 |
  | `BLOB` | 67108864 字节 |
  | `CLOB` | 67108864 字节 |

## 功能使用约束

### 备份恢复使用限制

在执行备份的备份操作（二次备份）时，需要保证源端备份中至少有一份有效备份数据。

### 主备库使用限制

| 限制项 | 描述 |
| --- | --- |
| 集群级同步 | 支持主备库按集群同步数据 |
| 租户级同步 | 不支持主备库按租户同步数据 |
| 备集群个数限制 | 31 个 |
| 备集群系统租户 DDL 个数限制 | 小于每秒 500 个 |
| 配置项是否同步 | 在主集群上修改配置项不影响备集群 |
| 普通租户的系统变量是否同步 | 在主集群上修改普通系统变量会同步到备集群 |
| 主集群非租户级别（例如，Table 级、Tablegroup 级、Database 级等）设置 Locality 和 Primary Zone | 不支持 |
| 主集群租户级别设置 Locality 和 Primary Zone | 支持 |
| 支持的副本类型 | - 支持全能型、日志型、只读型、加密投票型副本 - 不支持 Locality 混布 |
| 升级模式 | 支持从 V2.2.60 及之后的版本滚动升级 |
| GTS 开关限制 | 所有普通租户均开启 GTS |
| 分布式事务一阶段优化限制 | 主集群和备集群的一阶段优化开关 `enable_one_phase_commit` 关闭 |
| Schema 对象限制 | 支持复制表，但不能设置表级别的 Locality |
| 添加备集群限制 | - 升级后需要合并一轮才能接入备集群 - 要求备集群是空集群 - 要求主集群不能有处于分裂的表 - 要求主集群不能有非 Tenant 级别的 Locality、Primary Zone 等信息 - 要求主集群不处于升级阶段* 要求备集群的 OceanBase 数据库版本与主集群版本一致 - 要求 Schema 删除的副本全部 GC（Garbage Collection） - 所有普通租户必须打开 GTS 开关 - 要求主集群关闭一阶段优化开关 `enable_one_phase_commit` |
| 备集群操作限制 | 备集群不允许执行 DML 操作、显示开启事务、`SELECT FOR UPDATE` 以及 DDL 操作 |
| Switchover 限制 | - 主、备集群要求所有 Server 在线 - 不能出现合并 Error - Switchover 过程中停写，旧的主集群会最终返回 `4688` 或者超时 - 如果切换时间超过配置项 `max_stale_time_for_weak_consistency`（默认为 5 秒）的限制，则备集群停止弱一致性读服务 - 备集群上的 `enable_rereplication` 配置项要求打开，否则不能执行 Switchover 操作 - 一主多备的场景，需要所有备集群都在线，不在线的备集群必须处于 `DISABLED` 状态 - 要求主备集群的版本号一致 - 要求主集群不能处于物理备份中 - 要求没有 Restore 状态的副本 - 要求不能处于升级过程中 |
| Failover 限制 | - 支持最大性能模式 Failover - 有损 Failover 要求所有 Server 在线 - 执行 Failover 后，要求完成一轮合并才能接入备集群 |
| 保护模式限制 | - 支持最大性能模式 - 不支持最大保护模式和最大可用模式 |
| 物理备份恢复限制 | - 带备集群的情况下，主集群不支持执行恢复 - 备集群不支持备份和日志归档 - 不支持物理恢复一个备集群 - 主集群物理恢复一个租户后，要求合并一轮后才能添加备集群 |
| 解耦备集群限制 | - 要求集群角色为备集群（`PHYSICAL STANDBY`） - 要求备集群的所有 Server 均在线 - 要求主集群不处于升级阶段 - 支持执行解耦命令的 Switchover 状态为，`NOT ALLOWED`、`TO PRIMARY` 和 `DISCONNECT` |

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