配置最佳实践

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

本文主要介绍在黑屏部署 OceanBase 数据库后，针对不同业务应用场景，核心配置项与系统变量的推荐配置。

参数配置模板

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

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

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

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

• complex_oltp：本模版适用于银行、保险系统等工作负载，通常涉及复杂连接、复杂相关子查询、使用 PL 编写的批处理作业，同时存在长事务和大事务。对于短期运行的查询，有时会采用并行执行。在本场景下，相关推荐配置的详细介绍信息，可参见下文 complex_oltp。

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

• htap：本模版适用于 OLAP 和 OLTP 混合负载场景，包括不限于运营数据实时分析、欺诈行为检测、个性化推荐等。在本场景下，相关推荐配置的详细介绍信息，可参见下文 htap。

• 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;
   

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

   • MySQL 模式租户的配置示例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = True;
     ALTER SYSTEM SET _enable_filter_reordering = False;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 2;
     

   • Oracle 模式租户的配置示例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = True;
     ALTER SYSTEM SET "_enable_filter_reordering" = False;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 2;
     

complex_oltp

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

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

complex_oltp 场景示例

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

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

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

   • MySQL 模式租户的配置示例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = True;
     ALTER SYSTEM SET _enable_filter_reordering = False;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 2;
     

   • Oracle 模式租户的配置示例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = True;
     ALTER SYSTEM SET "_enable_filter_reordering" = False;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 2;
     

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. 在用户中执行以下语句，配置租户级配置项。

   • MySQL 模式租户的配置示例：

     ALTER SYSTEM SET default_table_store_format = 'column';
     ALTER SYSTEM SET _io_read_batch_size = '128K';
     ALTER SYSTEM SET _io_read_redundant_limit_percentage = 50;
     ALTER SYSTEM SET _io_callback_thread_count = 64;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = False;
     ALTER SYSTEM SET _nested_loop_join_enabled = False;
     ALTER SYSTEM SET default_table_organization = 'HEAP';
     ALTER SYSTEM SET default_table_merge_engine = 'DELETE_INSERT';
     ALTER SYSTEM SET default_micro_block_format_version = 2;
     ALTER SYSTEM SET _force_subquery_unnest = True;
     ALTER SYSTEM SET max_partition_num = 65536;
     

   • Oracle 模式租户的配置示例：

     ALTER SYSTEM SET default_table_store_format = 'column';
     ALTER SYSTEM SET "_io_read_batch_size" = '128K';
     ALTER SYSTEM SET "_io_read_redundant_limit_percentage" = 50;
     ALTER SYSTEM SET "_io_callback_thread_count" = 64;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = False;
     ALTER SYSTEM SET "_nested_loop_join_enabled" = False;
     ALTER SYSTEM SET default_table_organization = 'HEAP';
     ALTER SYSTEM SET default_table_merge_engine = 'DELETE_INSERT';
     ALTER SYSTEM SET default_micro_block_format_version = 2;
     ALTER SYSTEM SET "_force_subquery_unnest" = True;
     ALTER SYSTEM SET max_partition_num = 65536;
     

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

   • MySQL 模式租户的配置示例：

     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;
     

   • Oracle 模式租户的配置示例：

     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;
     

htap

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

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

htap 场景示例

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

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

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

   • MySQL 模式租户的配置示例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = True;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 2;
     ALTER SYSTEM SET max_partition_num = 65536;
     

   • Oracle 模式租户的配置示例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET default_load_mode = 'DISABLED';
     ALTER SYSTEM SET direct_load_allow_fallback = True;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 2;
     ALTER SYSTEM SET max_partition_num = 65536;
     

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. 在用户中执行以下语句，配置租户级配置项。

   • MySQL 模式租户的配置示例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET _enable_filter_reordering = False;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 2;
     ALTER SYSTEM SET enable_auto_split = True;
     

   • Oracle 模式租户的配置示例：

     ALTER SYSTEM SET log_transport_compress_all = True;
     ALTER SYSTEM SET "_enable_filter_reordering" = False;
     ALTER SYSTEM SET default_table_merge_engine = 'PARTIAL_UPDATE';
     ALTER SYSTEM SET default_micro_block_format_version = 2;
     ALTER SYSTEM SET enable_auto_split = True;
     

查看配置项和变量

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

  示例如下：

  SHOW PARAMETERS LIKE 'enable_syslog_recycle';
  

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

  • MySQL 模式：可以使用 SHOW [GLOBAL] VARIABLES LIKE 'variables_name'; 语句查询。

    示例如下：

    SHOW VARIABLES LIKE 'ob_query_timeout';
    

    SHOW GLOBAL VARIABLES LIKE 'ob_query_timeout';
    

  • Oracle 模式：可以使用视图 SYS.TENANT_VIRTUAL_SESSION_VARIABLE/SYS.TENANT_VIRTUAL_GLOBAL_VARIABLE 查询变量信息。

    示例如下：

    SELECT * FROM SYS.TENANT_VIRTUAL_SESSION_VARIABLE WHERE VARIABLE_NAME = 'ob_query_timeout';
    

    SELECT * FROM SYS.TENANT_VIRTUAL_GLOBAL_VARIABLE WHERE VARIABLE_NAME = 'ob_query_timeout';
    

相关文档

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