ob_compatibility_control

更新时间：2026-03-30 09:08:29

在 V4.3.x 版本中，该变量从 V4.3.2 版本开始引入。
在 V4.2.x 版本中，该变量从 V4.2.3 版本开始引入。

功能描述

ob_compatibility_control 用于控制 MYSQL5.7、 MYSQL8.0 有兼容性冲突时的行为模式。设定 ob_compatibility_control 值为 MYSQL5.7 时，不会影响无行为冲突的 MYSQL8.0 的特性使用。在创建租户时指定兼容模式，且在租户创建后无法修改。

功能适用性

该变量仅适用于 OceanBase 数据库 MySQL 模式。

权限要求

查询变量

sys 租户和所有用户租户均可以使用 SHOW VARIABLES 语句或视图 information_schema.GLOBAL_VARIABLES（MySQL 模式）查看 Global 系统变量的值。
修改变量

该变量在租户创建成功后，不支持通过 SQL 语句修改。

属性说明

属性	描述
参数类型	Enum
默认值	MYSQL5.7
取值范围	["MYSQL5.7"，"MYSQL8.0"]
生效范围	Global
是否可修改	否，该变量仅支持在创建租户时指定，租户创建后不支持通过 `SET` 或 `ALTER SESSION SET` 语句再修改。
是否只读	是

使用说明

对于无此变量的租户升级到有该变量控制的版本时，该变量取默认值 MYSQL5.7；对于新建租户，可以指定兼容模式。
对于历史版本中已经按 MySQL 8.0 实现的功能，如果 ob_compatibility_version < 4.2.3，不管 ob_compatibility_control 取何值，都根据 MySQL 8.0 来兼容。

配置示例

创建租户时指定兼容模式为 MySQL 5.7。

obclient> create tenant tenant_m57 zone_list=('z1'),primary_zone='z1',resource_pool_list=('pool1') set ob_compatibility_mode='mysql',ob_compatibility_control='MYSQL5.7',ob_tcp_invited_nodes='%';