管理参数

最近更新时间:2025-09-17 16:29:31

我的收藏
本文为您介绍只读分析引擎实例支持修改的参数。

前提条件

准备好只读分析引擎实例,请参见 开启只读分析引擎
实例状态为运行中。

管理参数

支持对只读分析引擎实例的参数进行管理,包括修改参数、参数模板的应用、查看参数修改记录等,操作方法与 TXSQL 引擎的只读实例基本一致,请参见 设置实例参数

参数列表

下表为只读分析引擎实例支持修改的参数列表与参数修改建议:

存储引擎参数

参数名
默认值
是否重启
参数修改建议
block_cache_capacity_mb
512
此参数控制只读分析引擎的缓存大小,单位为 MB。更大的缓存空间可以缓存更多的表数据,以提升多次执行 SQL 后的执行效率,避免重复从磁盘中扫描数据。
max_threads
16
此参数控制 SQL 在只读分析引擎中最大可使用的线程数。默认与实例规格的最大 CPU 保持一致,建议修改为实例规格的 CPU/2。
max_block_size
16
此参数控制向量化执行时单个数据块大小,单位为 MB。此值越大可能导致在查询粒度较细场景下产生过多的扫描成本。而此值过小会导致大量的快扫描,反而会降低性能。针对此参数的调优主要在查询的场景上,如果大部分的查询为大范围数据扫描计算的场景,则可以考虑将此值设置较大。如果大部分查询是简单的点查为主或者小结果集查询,则可以将此值设置小一些。

行列数据加载相关参数

参数名
默认值
是否重启
参数修改建议
replication_sink_parallelism
16
修改此参数可提升在数据增量加载时的并发数量。可提升增量数据加载的速度。但会增加对主实例的压力。请在主实例资源比较富余的时候调整此参数。
replication_dumper_table_parallel
4
通过此参数可控制同时启动数据全量加载的表数量。在主实例的资源充足的情况下,同时启动的表数量越多,全量数据加载的速度越快。请在主实例资源比较富余的时候调整此参数。
replication_dumper_insert_parallel
4
通过此参数可控制在全量数据加载时写入只读分析引擎的并发度。在只读分析引擎资源充足的情况下,写入并发数量越高,全量数据加载的速度越快。请在“只读分析引擎”资源较富余的时候调整此参数。
replication_dumper_select_parallel
16
通过此参数可控制在全量数据加载时有几个并发同时读取表数据。在主实例的资源充足的情况下,同时启动的并发数量越多,全量加载的速度就越快。请在主实例资源比较富余的时候调整此参数。
replication_dumper_chunk_size
10000
每一次加载全量数据时从主实例读取的 chunk 大小。chunk 越大,全量数据加载的速度越快,但是对主实例的资源消耗也更大一些。请根据主实例的资源使用实际情况调整此参数。

计算引擎相关参数

参数名
默认值
是否重启
参数修改建议
group_concat_max_len
1024
GROUP_CONCAT() 函数允许的最大入参长度。单位为 Byte。
libra_query_log_max_len
4096
此参数控制在慢日志管理中 SQL 记录的最大长度。单位为 KB。
libra_max_delay_allow_query
86400
此参数控制在分析引擎中执行 SQL 所涉及的对象允许的最大延迟。单位为秒。超过此时间,则在分析引擎执行 SQL 时会报错延迟过大。
libra_etl_concurrency
1
控制回写主实例的并发线程数。只有在 libra_concurrent_etl 设置为 ON 时才会生效。
libra_concurrent_etl
OFF
控制是否在回写主实例时开启并发写入。
libra_etl_to_rw
OFF
控制是否启用 加速 ETL 回写 功能。
libra_enable_snapshot_read
ON
控制分析引擎是否开启快照读功能。
libra_max_mpp_query_num
0
此参数控制分析引擎允许同时执行的 SQL 数量。默认为0,代表不限制。通常为了避免并发过高导致 SQL 消耗掉所有数据库资源时才开启。开启后,超过允许执行的 SQL 数量后,后续的 SQL 将被拒绝执行。
max_execution_time
0
此参数控制 SQL 允许执行的最长时间。单位为毫秒。超过此执行时间的 SQL 将被自动中断。默认为0,表示不会中断执行。
libra_preserve_order_for_pagination
OFF
此参数控制是否全局开启分页保序功能,详细功能介绍请参考 分页保序功能
libra_runtime_filter_type
MIN_MAX,BLOOM_FILTER,IN_FILTER
表示设置可以分配的 Runtime Filter 类型。
runtime_filter_max_in_num
1024
生成 IN 类型的 Runtime Filter 时允许的最大 NDV 值。
libra_enable_runtime_filter
ON
控制开启/关闭 Runtime Filter 功能。详细介绍可参考 Runtime Filter 使用手册
sql_mode
与主实例保持一致
此参数控制 SQL 在分析引擎的执行行为,参数值的行为逻辑与 MySQL 保持一致。但存在部分 SQL_MODE 不兼容或可配置但无法生效的情况,详情请参考文档 兼容性与使用限制 中的 SQL_MODE 部分。
libra_enable_late_materialization
ON
控制开启/关闭延迟物化功能。详细介绍可参考 延迟物化