本文介绍如何管理 TDSQL Boundless 只读分析实例的数据库参数，包括参数的查看、修改以及各参数的含义与取值范围。
前提条件
已 开启只读分析实例。
实例状态为运行中。
操作步骤
查看参数
1. 登录 TDSQL Boundless 控制台，在左侧导航栏选择实例列表。
2. 在实例列表中，单击目标只读分析实例的实例 ID，进入实例管理页。
3. 选择参数设置页签，查看当前实例所有可配置参数。
修改单个参数
1. 在数据库参数页签中，找到需要修改的参数。
2. 将鼠标悬停在参数当前值列，单击出现的
3. 在弹出的输入框中填写新值，单击
批量修改参数
1. 在数据库参数页签中，单击左上角批量修改参数。
2. 在弹出的面板中勾选并修改多个参数的值。
3. 单击确定提交修改。
说明：
修改参数前请仔细阅读参数可修改范围，超出范围的值将被拒绝。如果修改的参数需要重启实例才生效，建议您在业务低峰期操作，并确保应用程序具有重连机制。
参数列表
数据加载类参数
用于控制从 TDSQL Boundless 读写实例向只读分析实例同步数据时的性能参数。
参数名 | 默认值 | 可修改范围 | 是否重启生效 | 参数修改建议 |
replication_sink_parallelism | 16 | [1 - 64] | 否 | 修改此参数可提升在数据增量加载时的并发数量。可提升增量数据加载的速度，但会增加对读写实例的压力。请在读写实例资源比较富余的时候调整此参数。 |
replication_dumper_table_parallel | 2 | [1 - 1024] | 否 | 通过此参数可控制同时启动数据全量加载的表数量。在读写实例的资源充足的情况下，同时启动的表数量越多，全量数据加载的速度越快。请在读写实例资源比较富余的时候调整此参数。 |
replication_dumper_insert_parallel | 4 | [1 - 1024] | 否 | 通过此参数可控制在全量数据加载时写入只读分析实例的并发度。在只读分析实例资源充足的情况下，写入并发数量越高，全量数据加载的速度越快。请在“只读分析实例”资源较富余的时候调整此参数。 |
replication_dumper_select_parallel | 16 | [1 - 64] | 否 | 通过此参数可控制在全量数据加载时有几个并发同时读取表数据。在读写实例的资源充足的情况下，同时启动的并发数量越多，全量加载的速度就越快。请在读写实例资源比较富余的时候调整此参数。 |
replication_dumper_chunk_size | 10000 | [1000 - 5000000] | 否 | 每一次加载全量数据时从读写实例读取的 chunk 大小。chunk 越大，全量数据加载的速度越快，但是对读写实例的资源消耗也更大一些。请根据读写实例的资源使用实际情况调整此参数。 |
计算引擎类参数
用于控制 SQL 在列存只读分析引擎中的解析、执行、优化与运行时行为。
查询行为控制
参数名 | 默认值 | 可修改范围 | 是否重启生效 | 参数修改建议 |
sql_mode | 与读写实例保持一致 | 23项可选值任意组合，详见下方说明 | 否 | 此参数控制 SQL 在列存只读分析引擎的执行行为，参数值的行为逻辑与 MySQL 保持一致。但存在部分 SQL_MODE 不兼容或可配置但无法生效的情况。 |
max_execution_time | 0 | [0 - 86400000] | 否 | 此参数控制 SQL 允许执行的最长时间。单位为毫秒。超过此执行时间的 SQL 将被自动中断。默认为0，表示不会中断执行。 |
libra_max_delay_allow_query | 86400 | [1 - 31536000] | 否 | 此参数控制在列存只读分析引擎中执行 SQL 所涉及的对象允许的最大延迟。单位为秒。超过此时间，则在列存只读分析引擎执行 SQL 时会报错延迟过大。 |
libra_slow_log_threshold | 300 | [300 - 9223372036854775807] | 否 | 慢查询阈值，执行时间超过此值的 SQL 将被记入慢日志，单位秒。 |
libra_query_log_max_len | 4096 | [4096 - 4194304] | 否 | 此参数控制在慢日志管理中 SQL 记录的最大长度。单位为 KB。 |
group_concat_max_len | 1024 | [4 - 4294967295] | 否 | GROUP_CONCAT() 函数返回结果的最大长度，单位 Byte。 |
sql_mode 可选值：IGNORE_SPACE | ALLOW_INVALID_DATES | ANSI_QUOTES | ERROR_FOR_DIVISION_BY_ZERO |HIGH_NOT_PRECEDENCE | NO_AUTO_CREATE_USER | NO_AUTO_VALUE_ON_ZERO |NO_BACKSLASH_ESCAPES | NO_DIR_IN_CREATE | NO_ENGINE_SUBSTITUTION |NO_FIELD_OPTIONS | NO_KEY_OPTIONS | NO_TABLE_OPTIONS | NO_UNSIGNED_SUBTRACTION |NO_ZERO_DATE | NO_ZERO_IN_DATE | ONLY_FULL_GROUP_BY | PAD_CHAR_TO_FULL_LENGTH |PIPES_AS_CONCAT | REAL_AS_FLOAT | STRICT_ALL_TABLES | STRICT_TRANS_TABLES
执行优化
参数名 | 默认值 | 可修改范围 | 是否重启生效 | 参数修改建议 |
libra_enable_runtime_filter | ON | [ON | OFF] | 否 | 控制开启/关闭 Runtime Filter 功能。 |
libra_runtime_filter_type | MIN_MAX,BLOOM_FILTER,IN_FILTER,TOPN_FILTER | 4 项可选值任意组合 | 否 | 表示设置可以分配的 Runtime Filter 类型。 |
libra_enable_late_materialization | ON | [ON | OFF] | 否 | 控制开启/关闭延迟物化功能。 |
libra_enable_snapshot_read | ON | [ON | OFF] | 否 | 控制列存只读分析引擎是否开启快照读功能。 |
libra_preserve_order_for_pagination | OFF | [ON | OFF] | 否 | 此参数控制是否全局开启分页保序功能。 |
libra_max_mpp_query_num | 0 | [0 - 1000000] | 否 | 此参数控制列存只读分析引擎允许同时执行的 SQL 数量。默认为0，代表不限制。通常为了避免并发过高导致 SQL 消耗掉所有数据库资源时才开启。开启后，超过允许执行的 SQL 数量后，后续的 SQL 将被拒绝执行。 |
ETL 相关
参数名 | 默认值 | 可修改范围 | 是否重启生效 | 参数修改建议 |
libra_concurrent_etl | OFF | [ON | OFF] | 否 | 控制是否在回写读写实例时开启并发写入。 |
libra_etl_concurrency | 1 | [1 - 128] | 否 | 控制回写读写实例的并发线程数。只有在 libra_concurrent_etl 设置为 ON 时才会生效。 |
libra_etl_to_rw | OFF | [ON | OFF] | 否 | 控制是否启用 加速 ETL 回写 功能。 |
存储引擎类参数
用于控制底层存储的块大小、线程数、缓存容量等资源配置。
参数名 | 默认值 | 可修改范围 | 是否重启生效 | 参数修改建议 |
max_block_size | 65409 | [0 - 4294967295] | 否 | 此参数控制向量化执行时单个数据块大小，单位为 MB。此值越大可能导致在查询粒度较细场景下产生过多的扫描成本。而此值过小会导致大量的块扫描，反而会降低性能。针对此参数的调优主要在查询的场景上，如果大部分的查询为大范围数据扫描计算的场景，则可以考虑将此值设置较大。如果大部分查询是简单的点查为主或者小结果集查询，则可以将此值设置小一些。 |
max_threads | 16 | [0 - 1024] | 否 | 此参数控制 SQL 在列存只读分析引擎中最大可使用的线程数。默认与实例规格的最大 CPU 保持一致，建议修改为实例规格的 CPU/2。 |
runtime_filter_max_in_num | 1024 | [0 - 4294967295] | 否 | 生成 IN 类型的 Runtime Filter 时允许的最大 NDV 值。 |
block_cache_capacity_mb | 512 | [0 - 2147483647] | 是 | 此参数控制只读分析实例的缓存大小，单位为 MB。更大的缓存空间可以缓存更多的表数据，以提升多次执行 SQL 后的执行效率，避免重复从磁盘中扫描数据。 该参数修改后需要重启实例才能生效。 |
