OceanBase Oracle模式下运维常用的变量

说明

• OceanBase 数据库的系统变量分为全局变量(GLOBAL)和 Session 变量(SESSION)。
• 全局变量：表示 Global 级别的修改，数据库同一租户内的不同用户共享全局变量。全局变量的修改不会随会话的退出而失效。此外，全局变量修改后，对当前已打开的 Session 不生效，需要重新建立 Session 才能生效。
• Session 变量：表示 Session 级别的修改。当客户端连接到数据库后，数据库会复制全局变量来自动生成 Session 变量。Session 变量的修改仅对当前 Session 生效。

查询方式

# Session 级别的变量查询
obclient> SHOW VARIABLES LIKE 'ob_query_timeout';
obclient> SELECT * FROM SYS.TENANT_VIRTUAL_SESSION_VARIABLE WHERE VARIABLE_NAME = 'ob_query_timeout';

# Global 级别的变量查询
obclient> SHOW GLOBAL VARIABLES LIKE 'ob_query_timeout';
obclient> SELECT * FROM SYS.TENANT_VIRTUAL_GLOBAL_VARIABLE WHERE VARIABLE_NAME = 'ob_query_timeout';

修改方式

# Session 级别的修改变量
obclient> SET ob_query_timeout = 7200000000;
obclient> ALTER SESSION SET ob_query_timeout = 7200000000;

# Global 级别的修改变量
obclient> SET GLOBAL ob_query_timeout = 7200000000;
obclient> ALTER SYSTEM SET ob_query_timeout = 7200000000;

autocommit

• autocommit 用于设置是否自动提交事务。

ob_query_timeout

• ob_query_timeout 用于设置对 SQL 语句进行 DML 操作的超时时间，单位是微秒(μs)。
• 1秒(s) = 1000 毫秒(ms) = 1,000,000 微秒(μs) = 1,000,000,000 纳秒(ns) = 1,000,000,000,000 皮秒(ps)

ob_trx_timeout

• ob_trx_timeout 用于设置事务超时时间，单位是微秒(μs)。

ob_trx_idle_timeout

• ob_trx_idle_timeout 用于设置事务空闲超时时间，即事务中两条语句之间的执行间隔超过该值时超时，单位是微秒(μs)。

ob_trx_lock_timeout

• ob_trx_lock_timeout 用于设置事务的等锁超时时长，单位是微秒(μs)。

connect_timeout

• connect_timeout 用于设置连接超时时间，单位为秒。

group_concat_max_len

• group_concat_max_len 用于设置允许的 GROUP_CONCAT() 函数结果的最大长度，单位为字节。

lower_case_table_names

• lower_case_table_names 用于设置是否对大小写敏感。
• 该变量仅对 DataBase 和 Table 对象名生效。

• 使用 CREATE TENANT 语句创建租户时，指定 lower_case_table_names 变量的值为 0 的示例如下：

CREATE TENANT IF NOT EXISTS t1 zone_list = ('zone1'), primary_zone = 'zone1', resource_pool_list = ('pool1') SET ob_compatibility_mode = 'MYSQL', lower_case_table_names = 0;

ob_compatibility_mode

• ob_compatibility_mode 用于指定租户的兼容模式。

• 使用 CREATE TENANT 语句创建租户时，指定 ob_compatibility_mode 变量的值为 mysql 的示例如下：

CREATE TENANT IF NOT EXISTS t1 zone_list = ('zone1'), primary_zone = 'zone1', resource_pool_list = ('pool1') SET ob_compatibility_mode = 'MYSQL', lower_case_table_names = 0;

max_allowed_packet

• max_allowed_packet 用于设置最大网络包大小，单位是 Byte。

ob_plan_cache_percentage

• ob_plan_cache_percentage 用于设置计划缓存可使用内存占租户内存的百分比。
• 计划缓存最多可使用内存（内存上限绝对值）= 租户内存上限 * ob_plan_cache_percentage/100。

ob_sql_work_area_percentage

• ob_sql_work_area_percentage 用于 SQL 执行的租户内存百分比限制。

ob_tcp_invited_nodes

• ob_tcp_invited_nodes 用于设置租户的 IP 白名单，支持百分号（%） 、短横线（_） 和 IP（多个 IP 之间用逗号分隔），支持 IP 列表匹配、掩码匹配和模糊匹配。

read_only

• read_only 用于设置租户是否为只读模式。
• 设置后，会影响该租户下的所有普通用户，不影响 root 权限用户。

recyclebin

• recyclebin 用于设置是否开启回收站功能。
• 启用回收站后，删除的表及其依赖对象将放置在回收站中；当禁用回收站时，删除的表及其依赖对象不会放置在回收站中，会直接删除。

transaction_isolation

• transaction_isolation 用于设置事务的隔离级别。

tx_isolation

• tx_isolation 用于设置事务隔离级别。

undo_retention

• undo_retention 表示系统应保留的多版本数据范围，单位为秒，在转储时控制多版本数据的回收。
• OceanBase 数据库转储的数据会保留多个版本的历史数据行，您可以通过 undo_retention 来控制转储中保留的多版本数据范围。
  其中：
  当 undo_retention 的值为 0 时，表示未开启多版本转储，即转储文件仅保留当前最新版本的行数据。
  当 undo_retention 的值大于 0 时，表示开启多版本转储，并且转储文件保留这段时间（单位为秒）以内的多版本行数据。
• 租户开启多版本转储后，大版本合并会保留对应的增量转储文件，但 Major SSTable 中不会存放多版本数据。建议该参数不要设置过大，防止因参数过大而导致保留的 SSTable 数量超限。

wait_timeout

• wait_timeout 用于设置服务器关闭非交互连接之前等待活动的秒数。
• 在会话启动时，会根据全局 wait_timeout 的值或全局 interactive_timeout 的值来初始化会话 wait_timeout 的值，具体根据全局 wait_timeout 的值还是全局 interactive_timeout 的值取决于客户端类型。客户端类型由 mysql_real_connect() 的连接选项 CLIENT_INTERACTIVE 定义。

default_password_lifetime

• default_password_lifetime 用于设置密码的过期时间。

validate_password_check_user_name

• validate_password_check_user_name 用于设置用户密码是否可以和用户名相同。
• 该变量需要与 validate_password_policy 变量配合使用，仅当 validate_password_policy 取值为 MEDIUM 时，该变量才会生效。

validate_password_length

• validate_password_length 设置用户密码最小长度。

validate_password_mixed_case_count

• validate_password_mixed_case_count 用于设置用户密码至少包含的大写字母个数以及至少包含的小写字母个数。

validate_password_number_count

• validate_password_number_count 用于设置用户密码至少包含的数字个数。

validate_password_policy

• validate_password_policy 用于设置密码检查策略。

validate_password_special_char_count

• validate_password_special_char_count 用于设置用户密码至少包含的特殊字符个数。