---
title: "推荐配置 - OceanBase Database AI V4.6.2 | OceanBase 文档中心"
description: 推荐配置 为了确保用户在各种业务场景下，能够基于 OceanBase Database AI 获得比较好的性能，OceanBase 基于过往大量真实场景的调优经验总结了各类业务场景下一些核心配置项和变量的推荐配置。OceanBase 云平台（OceanBase Cloud Platform，简称：OCP）支持用户在创…
image: https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*OSPzQ6GUQF4AAAAAQHAAAAgAeiGDAQ/original
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*inJjSpyNOjUAAAAAHtAAAAgAeiGDAQ/original) OceanBase Database AIV 4.6.2

# 推荐配置

更新时间：2026-08-17 14:28:20

[编辑](https://github.com/oceanbase/oceanbase-database-ai/edit/V4.6.2/zh-CN/150.deploy/900.best-practices.md)  

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

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

## 参数配置模板

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

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

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

- `express_oltp`：本模版适用于交易、支付核心系统、互联网高吞吐量应用等工作负载类型，无外键约束、无存储过程、无长事务、无大事务、无复杂连接及复杂子查询等限制。向量混搜等 AI 负载以及历史库负载推荐使用此模板。在本场景下，相关推荐配置的详细介绍信息，可参见下文 [express_oltp](#express_oltp)。
 - `olap`：本模版主要用于实时数据仓库分析应用。在本场景下，相关推荐配置的详细介绍信息，可参见下文 [olap](#olap)。
 - `kv`：本模版适用于 HBase 兼容和 Key-Value 表模型访问模式，单分区访问，无 SQL 层。此场景通常伴随着极高的数据吞吐量需求，并且对延迟非常敏感。在本场景下，相关推荐配置的详细介绍信息，可参见下文 [kv](#kv)。

## express_oltp

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

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

| **配置项** | **推荐值** | **推荐值说明** | **级别** |
| --- | --- | --- | --- |
| [enable_record_trace_log](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781387) | False | 禁止记录 SQL 和事务跟踪事件。 | cluster |
| [enable_syslog_recycle](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781245) | True | 启用 syslog 自动回收可以防止日志文件填满磁盘空间。 | cluster |
| [max_syslog_file_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781365) | 300 | 启用 `enable_syslog_recycle` 时，应将该值设置为适当的值。300 是一个经验值。 | cluster |
| [large_query_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781381) | 600s | 对于复杂的 OLTP 场景，一些查询将运行很长时间。 | cluster |
| [inc_sstable_upload_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781122) | 30 | 租户用于执行共享存储模式下数据共享类任务的线程数。 | tenant |
| [enable_rebalance](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781218) | False | 关闭自动负载均衡。 | tenant |

### express_oltp 场景配置示例

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

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

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

   ```

## olap

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

| **配置项** | **推荐值** | **推荐值说明** | **级别** |
| --- | --- | --- | --- |
| [enable_record_trace_log](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781387) | False | 禁止记录 SQL 和事务跟踪事件。 | cluster |
| [enable_syslog_recycle](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781245) | True | 启用 syslog 自动回收可以防止日志文件填满磁盘空间。 | cluster |
| [max_syslog_file_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781365) | 300 | 启用 `enable_syslog_recycle` 时，应将该值设置为适当的值。300 是一个经验值。 | cluster |
| [large_query_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781381) | 0ms | 表示关闭大查询的检测。 | cluster |
| [trace_log_slow_query_watermark](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781300) | 7d | AP 场景下无需定义慢查询。 | cluster |
| [inc_sstable_upload_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781122) | 30 | 租户用于执行共享存储模式下数据共享类任务的线程数。 | tenant |
| [ha_high_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781149) | 20 | 设置高可用高优先级线程的当前工作线程数。 | tenant |
| [direct_load_allow_fallback](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781107) | False | 对于经典的 OLAP 工作负载，当旁路导入失败时直接报错，不允许回退成普通导入方式。 | tenant |
| [default_table_merge_engine](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781092) | DELETE_INSERT | 使用 `delete_insert` 合并引擎处理 OLAP 工作负载。 | tenant |
| [default_table_store_format](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781217) | column | AP 默认格式指定为纯列存表。 | tenant |
| [default_table_organization](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781070) | HEAP | 默认堆表，数据按照写入顺序存储，和主键序无关。 | tenant |
| [max_partition_num](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781197) | 65536 | 将 AP/HTAP 工作负载的每个表的最大分区数增加到 65536，支持按时间范围和哈希子分区进行大规模分区，这在数据仓库和实时分析场景中很常见。 | tenant |
| [default_skip_index_level](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781168) | 1 | 设置租户中创建表时 skip_index_level 的默认值。 | tenant |
| [default_delta_format](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781130) | encoding | 设置创建表时默认的增量数据存储格式为 encoding。 | tenant |
| [enable_rebalance](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781218) | False | 关闭自动负载均衡。 | tenant |

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

| **变量** | **推荐值** | **推荐值说明** | **级别** |
| --- | --- | --- | --- |
| [ob_query_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781003) | 604800000000 | 设置为 7 天。 | tenant |
| [ob_trx_timeout](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006780989) | 604800000000 | 设置为 7 天。 | tenant |
| [parallel_min_scan_time_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781031) | 10 | 对于执行时间在 100ms+ 的查询，可以带来最佳的并行执行性能。 | tenant |
| [ob_sql_work_area_percentage](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006780957) | 30 | 设置比较大的工作区内存可以节省内存泄漏带来的成本。 | tenant |
| [parallel_degree_policy](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006780897) | AUTO | 表示启用 Auto DOP 策略。   关于 Auto DOP 的详细介绍，参见 [Auto DOP](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006780882)。 | tenant |
| [collation_server](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006780907) | utf8mb4_bin | 相较其他 collation，使用二进制 collation 可以实现 20% 的性能提升。 | tenant |
| [collation_connection](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781010) | utf8mb4_bin | 相较其他 collation，使用二进制 collation 可以实现 20% 的性能提升。 | tenant |

### olap 场景配置示例

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

   ```sql
   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;

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

   ```sql
   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 场景配置项推荐值的详细介绍如下：**

| **配置项** | **推荐值** | **推荐值说明** | **级别** |
| --- | --- | --- | --- |
| [enable_record_trace_log](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781387) | False | 禁止记录 SQL 和事务跟踪事件。 | cluster |
| [enable_syslog_recycle](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781245) | True | 启用 syslog 自动回收可以防止日志文件填满磁盘空间。 | cluster |
| [max_syslog_file_count](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781365) | 300 | 启用 `enable_syslog_recycle` 时，应将该值设置为适当的值。300 是一个经验值。 | cluster |
| [large_query_threshold](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781381) | 0ms | 禁用 KV 模式的大型查询检测。 | cluster |
| [inc_sstable_upload_thread_score](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781122) | 30 | 租户用于执行共享存储模式下数据共享类任务的线程数。 | tenant |
| [enable_rebalance](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006781218) | False | 关闭自动负载均衡。 | tenant |

### kv 场景配置示例

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

   ```sql
   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;

   ```

## 查看配置项和变量

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

  示例如下：

  ```sql
  SHOW PARAMETERS LIKE 'enable_syslog_recycle';

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

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

  示例如下：

  ```sql
  SHOW VARIABLES LIKE 'ob_query_timeout';

  ```

  ```sql
  SHOW GLOBAL VARIABLES LIKE 'ob_query_timeout';

  ```

## 相关文档

- 有关配置项和变量的详细介绍，参见 [配置项和系统变量概述](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006779238)。
 - 有关配置项的设置方法，参见 [设置参数](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006779430)。
 - 有关变量的设置方法，参见 [设置变量](https://www.oceanbase.com/docs/common-oceanbase-database-ai-1000000006779431)。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线