使用限制

本篇介绍 OceanBase 开发者中心（OceanBase Developer Center，ODC）安装部署的环境要求以及各功能模块所涉及的使用限制。

部署环境限制

Web 版

桌面版

产品能力限制

数据源类型支持概览

数据源版本支持限制

权限限制

• 为了避免其它操作对元数据库的影响，建议使用独立的数据库作为 ODC 的元数据库。用于 ODC 访问元数据库的用户需要拥有该库的所有权限。授权数据库所有权限：GRANT ALL PRIVILEGES ON odc_metadb.* TO 'user'@'host';。

• OceanBase V4.0.0 及之后的版本，若要进行调试，需保证用户已具备调试权限。调试权限：GRANT DEBUG CONNECT SESSION TO <user>; GRANT DEBUG ANY PROCEDURE TO <user>。

• 针对 OceanBase 数据源，若需要较好的导数速度，需要配置 sys 租户账号。

任务数并发限制

工单并发调度

ODC V4.3.3-bp2 及之后版本：每个节点允许最大任务数为 Jvm 的 CPU 数 * 10，超过这个上限的任务会直接失败。同时导数任务单独有一个上限，是取 Jvm 的 CPU 数 和 5 的最大值。

作业并发调度

每个 ODC 节点最大允许运行任务数计算逻辑如下：

1. 获取系统的总体的物理内存，MemTotal
2. 获取当前Jvm的最大内存（ODC Docker 内存配置）， MemTakenByODC
3. 获取运行任务的最小内存（默认为 1G），MinMemProcessNeed
4. 作业并发数计算逻辑为 (MemTotal * 0.8 - MemTakenByODC) / MinMemProcessNeed

功能使用限制

会话限制

• ODC 提供了手动、自动两种事务提交模式。手动提交模式下，若数据源为 OceanBase 数据源，为了避免因为事务内两个 SQL 之间的执行间隔超过 ob_trx_idle_timeout 设置的时间而导致连接被终止，需要合理设置 ob_trx_idle_timeout 大小。一般情况下 ob_trx_idle_timeout 的大小需大于 SQL 查询超时时间，同时需要注意该参数设置过大会导致该会话占用内存无法及时释放，需谨慎设置。

PL 限制

ODC PL 支持现状

SQL 开发限制

• 编辑结果集时，不支持对包含 SET、ENUM 字段类型的查询结果集进行编辑。

• 全链路追踪仅支持 OceanBase V4.0.0 及之后的版本。

• SQL 实时剖析仅支持 OceanBase V4.2.4 及之后的版本、V4.3.3.1 及之后的版本。

命令行窗口限制

• MacOS 桌面版不提供命令行窗口。

• 最多可同时打开 3 个命令行窗口。

• 命令行窗口操作暂未纳入操作记录。

数据脱敏限制

• 数据脱敏暂未覆盖命令行窗口场景。

• 数据脱敏暂未覆盖 PL 执行场景。

• 配置识别规则脚本时，Groovy 只允许用户使用 Java 中的 Objects 类 和 String 类。

• 配置识别规则脚本时，不支持 Groovy 闭包、自带的闭包函数。

• MySQL 数据源导出若涉及敏感数据使用全部遮掩算法脱敏。

• Oracle 数据源导出若涉及敏感数据使用全部遮掩算法脱敏。

• Doris 数据源导出若涉及敏感数据使用全部遮掩算法脱敏。

SSO 集成限制

• OAUTH/OIDC 只支持授权码模式。
• OAUTH/OIDC 退出登录时，只清除 ODC 应用的登录态，不会清理 SSO 系统的登录态。

大模型集成限制

• 需要配置向量库，OB 版本要求 433 及以上。

工单使用限制

导入与导出限制

• 通用限制：

  • 导入导出任务涉及的文件默认保留 14 天。
  • 导出任务详情中导出对象的数据总记录数依赖 OB 视图，并非精准值。
  • 在 ODC 4.1.0 之后版本，针对 OceanBase 数据源，配置 sys 租户账号可以提升导入导出速度。同时导出除表、视图之外的其它对象时不再要求必须配置 sys 租户账号。

• 导出限制：

  • Web 版 ODC 对导出结果集条数没有硬限制，但是最大支持导出 2GB 的数据（压缩前）。
  • Web 版 ODC 对导出的数据大小有限制，最大支持导出 2GB 的数据（压缩前），超出部分无法导出。如需导出大量数据，请使用导数工具 OBDUMPER。
  • 需注意外键包含多列时，导出时无法保证外键中列的顺序；如：FOREIGN KEY(c1,c2) REFERENCE ..。

• 导入限制：

  • Web 版 ODC 对导入上传的文件大小有限制，最大支持导入 2GB（压缩后）的文件，超出部分无法上传。如需导入大量数据，请使用导数工具 OBLOADER。
  • 有外键表的数据导入，因为无法保证关联表的导入顺序，可能会导入失败。
  • 需注意导入的数据文件名要与导入的目标表名大小写一致 。
  • 需注意单表导入时，若选择的数据文件中包含其它表数据，会把其它表也会导入。
  • 需注意使用 SQL 文件导入时，若 SQL 文件中包含 create table 语句，若结构已存在将跳过结构处理，仅在日志中提示报错。

数据库变更限制

自动回滚脚本限制：

• 只支持对 UPDATE 和 DELETE 变更语句自动生成回滚语句。

• 支持的变更影响行数上限为 100W，超过则不支持自动生成回滚语句。

• 若表中包含大字段，不支持自动生成回滚语句。

• OceanBase MySQL、MySQL 数据源下，若表中无主键或者唯一键，不支持自动生成回滚语句。

• UPDATE 语句的修改字段（SET）和条件字段（WHERE）相同，不支持自动生成回滚语句。

• 最大支持生成的自动回滚语句脚本大小为 256MB。

模拟数据限制

• 单次模拟数据上限为 1 亿行。

• 拥有检查约束的表，不支持对其进行模拟数据。

• Range，List 分区表不支持对其进行模拟数据。

结构比对限制

• 链路支持：

  • OceanBase MySQL 到 OceanBase MySQL。

  • OceanBase Oracle 到 OceanBase Oracle。

  • MySQL 到 MySQL。

• 仅支持比对表对象，比对属性范围仅包含列、主键、约束、索引、分区、表属性。

  • 关于列属性，仅支持比对类型、字符集、排序规则、注释、缺省值。

  • 关于分区，仅支持比对一级分区不支持比对二级分区。

  • 关于表属性，仅支持比对字符集、排序规则、注释。

• OceanBase MySQL 不支持比对检查约束。

• 不支持比对存在外键约束的表。

多库变更

• 仅支持同构数据源多库变更。

无锁结构变更限制

• 表中须存在主键或非空唯一键且表中不存在外键。

• OceanBase MySQL 模式下的表名称不超过 54 个字符，OceanBase Oracle 模式下的表名称不超过 118 个字符。

• ODC 连接 OceanBase 社区版数据库时，数据源配置信息中需包含集群名和 SYS 租户账号。

• 默认通过锁定用户且关闭会话的方式避免表名切换过程中数据的写入，部分版本（OceanBase MySQL V4.2.5 及之后且 OceanBase MySQL V4.3.0 之前的版本）通过特定配置以 LOCK TABLE 方式避免数据写入。具体配置请参见 新建无锁结构变更任务。

• 无锁结构变更期间，发起其它关于该表的 DDL 变更将导致任务失败。

• 使用阿里云数据库 OceanBase 版 ODC 创建无锁结构变更任务前，须确认已存在 OMS 空闲实例。

无锁结构变更支持的变更范围：

逻辑库使用限制

• 仅支持 OceanBase MySQL、MySQL 数据源。

• 仅支持 DDL 变更。

• 不支持 ODC 安全规范中的 SQL 检查规范及 SQL 窗口规范。

作业使用限制

分区计划限制

• 仅支持 OceanBase MySQL 和 OceanBase Oracle 数据源。

• 仅支持 Range 分区表。

• Range 分区表中的最后一个分区上限值为 MAXVALUE 时，数据库不允许新增分区，因此不支持通过 ODC 分区计划任务创建分区策略。

• 分区计划任务下发后，涉及到的表不存在时，任务无法执行。

数据归档限制

• 前置条件：

  • 归档的表中必须包含主键，若数据源类型为 OceanBase MySQL 及 MySQL，则包含唯一索引也可进行归档。

  • 用于归档的数据库用户需要拥有读/写权限和内部视图的访问权限。权限配置请参见 查看用户权限、用户及权限概述 和 修改用户权限。

  • 需保证源端表字段在目标端兼容，数据归档不处理字段兼容性问题。

  • 同构归档链路二级分区不支持表结构同步，异构数据库不支持结构同步以及自动建表。

• 归档链路支持：

  • OceanBase MySQL 、MySQL 到 OceanBase MySQL。

  • OceanBase Oracle 、Oracle 到 OceanBase Oracle。

  • OceanBase MySQL、MySQL 到 MySQL。

  • OceanBase Oracle 、Oracle 到 Oracle。

  • PostgreSQL 到 OceanBase MySQL。

  • OceanBase MySQL、OceanBase Oracle、MySQL、Oracle、PostgreSQL 到对象存储（OSS、COS、OBS、S3）。

• 以下情况不支持归档：

  • OceanBase MySQL 数据源若表中包含 XMLTYPE 字段类型，不支持进行归档。

  • OceanBase Oracle 数据源若表中包含 JSON、XMLTYPE 字段类型，不支持归档。

  • PostgreSQL 数据源若表定义中包含数组类型、复合类型、枚举类型、几何类型、XML 类型、HSTORE 类型、全文检索，不支持归档。

  • 若归档条件中包含 LIMIT 语句，不支持归档。

  • 若表中包含外键，不支持归档。

• 支持自动建表链路

  • OceanBase Oracle 到 OceanBase Oracle。
  • OceanBase MySQL 到 OceanBase MySQL。
  • MySQL 到 MySQL（MySQL 5.7 之前的版本除外）。

• 支持表结构同步链路

  • OceanBase MySQL 到 OceanBase MySQL。

数据清理限制

• 前置条件：

  • 清理的表中必须包含主键，若数据源类型为 OceanBase MySQL 及 MySQL，则包含唯一索引也可进行清理。

  • 用于清理的数据库用户需要拥有读/写权限和内部视图的访问权限。权限配置请参见 查看用户权限、用户及权限概述 和 修改用户权限。

• 清理数据源支持：

  • OceanBase MySQL 数据源。

  • OceanBase Oracle 数据源。

  • MySQL 数据源。

  • Oracle 数据源。

  • PostgreSQL 数据源。

• 以下情况不支持清理：

  • OceanBase MySQL 数据源若表中包含 XMLTYPE 字段类型，不支持清理。

  • OceanBase Oracle、Oracle 和 PostgreSQL 数据源若表中不包含主键 PRIMARY KEY，不支持清理。

  • OceanBase Oracle 数据源若表中包含 JSON、XMLTYPE 字段类型，不支持清理。

  • 若清理条件中包含 LIMIT 语句，不支持清理。

  • 若表中包含外键，不支持清理。