推荐配置

为了确保用户在各种业务场景下，能够基于 OceanBase Database AI 获得比较好的性能，OceanBase 基于过往大量真实场景的调优经验总结了各类业务场景下一些核心配置项和变量的推荐配置。OceanBase 云平台（OceanBase Cloud Platform，简称：OCP）支持用户在创建租户时在参数设置中选择参数模板，基于用户选择的参数模板，通过读取对应版本内核的 RPM 包内容获得对应参数取值。使用 OCP 创建租户的信息，参见 新建主租户。

本文主要介绍针对不同业务应用场景，核心配置项与系统变量的推荐配置。

参数配置模板

安装 OceanBase Database AI RPM 包后，可以在 /home/admin/oceanbase/etc 目录下查看不同业务场景下的推荐参数配置的参数配置模板。

• default_parameter.json：保存了配置项的推荐配置。
• default_system_variable.json：保存了变量的推荐配置。

参数配置文件中的模版分类：

• express_oltp：本模版适用于交易、支付核心系统、互联网高吞吐量应用等工作负载类型，无外键约束、无存储过程、无长事务、无大事务、无复杂连接及复杂子查询等限制。向量混搜等 AI 负载以及历史库负载推荐使用此模板。在本场景下，相关推荐配置的详细介绍信息，可参见下文 express_oltp。

• olap：本模版主要用于实时数据仓库分析应用。在本场景下，相关推荐配置的详细介绍信息，可参见下文 olap。

• kv：本模版适用于 HBase 兼容和 Key-Value 表模型访问模式，单分区访问，无 SQL 层。此场景通常伴随着极高的数据吞吐量需求，并且对延迟非常敏感。在本场景下，相关推荐配置的详细介绍信息，可参见下文 kv。

express_oltp

在本场景下，当前暂无变量配置推荐。

express_oltp 场景配置项推荐值的详细介绍如下：

express_oltp 场景配置示例

1. 在 sys 租户中执行以下语句，配置集群级配置项。

   ALTER SYSTEM SET enable_record_trace_log = False;
   ALTER SYSTEM SET enable_syslog_recycle = True;
   ALTER SYSTEM SET max_syslog_file_count = 300;
   ALTER SYSTEM SET max_syslog_file_count = '600s';
   

2. 在用户中执行以下语句，配置租户级配置项。

   ALTER SYSTEM SET inc_sstable_upload_thread_score = 30;
   ALTER SYSTEM SET enable_rebalance = False;
   

olap

olap 场景配置项推荐值的详细介绍如下：

olap 场景变量推荐值的详细介绍如下：

olap 场景配置示例

1. 在 sys 租户中执行以下语句，配置集群级配置项。

   ALTER SYSTEM SET enable_record_trace_log = False;
   ALTER SYSTEM SET trace_log_slow_query_watermark = '7d';
   ALTER SYSTEM SET large_query_threshold = '0ms';
   ALTER SYSTEM SET enable_syslog_recycle = True;
   ALTER SYSTEM SET max_syslog_file_count = 300;
   

2. 在用户中执行以下语句，配置租户级配置项。

   ALTER SYSTEM SET inc_sstable_upload_thread_score = 30;
   ALTER SYSTEM SET ha_high_thread_score = 20;
   ALTER SYSTEM SET direct_load_allow_fallback = False;
   ALTER SYSTEM SET default_table_merge_engine = 'DELETE_INSERT';
   ALTER SYSTEM SET default_table_store_format = 'column';
   ALTER SYSTEM SET default_table_organization = 'HEAP';
   ALTER SYSTEM SET max_partition_num = 65536;
   ALTER SYSTEM SET default_skip_index_level = 1;
   ALTER SYSTEM SET default_delta_format = 'encoding';
   ALTER SYSTEM SET enable_rebalance = False;
   

3. 在用户中执行以下语句，配置租户级变量。

   SET GLOBAL ob_query_timeout = 604800000000;
   SET GLOBAL ob_trx_timeout = 604800000000;
   SET GLOBAL parallel_min_scan_time_threshold = 10;
   SET GLOBAL ob_sql_work_area_percentage = 30;
   SET GLOBAL parallel_degree_policy = AUTO;
   SET GLOBAL collation_server = utf8mb4_bin;
   SET GLOBAL collation_connection = utf8mb4_bin;
   

kv

在本场景下，当前暂无变量配置推荐。

kv 场景配置项推荐值的详细介绍如下：

kv 场景配置示例

1. 在 sys 租户中执行以下语句，配置集群级配置项。

   ALTER SYSTEM SET enable_record_trace_log = False;
   ALTER SYSTEM SET large_query_threshold = '0ms';
   ALTER SYSTEM SET enable_syslog_recycle = True;
   ALTER SYSTEM SET max_syslog_file_count = 300;
   

2. 在用户中执行以下语句，配置租户级配置项。

   ALTER SYSTEM SET inc_sstable_upload_thread_score = 30;
   ALTER SYSTEM SET enable_rebalance = False;
   

查看配置项和变量

• 可以使用 SHOW PARAMETERS LIKE 'parameter_name'; 语句查询配置项信息。

  示例如下：

  SHOW PARAMETERS LIKE 'enable_syslog_recycle';
  

• 可以使用下面语句查询变量信息。

  可以使用 SHOW [GLOBAL] VARIABLES LIKE 'variables_name'; 语句查询。

  示例如下：

  SHOW VARIABLES LIKE 'ob_query_timeout';
  

  SHOW GLOBAL VARIABLES LIKE 'ob_query_timeout';
  

相关文档

• 有关配置项和变量的详细介绍，参见 配置项和系统变量概述。
• 有关配置项的设置方法，参见 设置参数。
• 有关变量的设置方法，参见 设置变量。