查看和配置系统参数

什么是系统参数？

在 RisingWave 中，高级用户可以使用系统参数来调整 RisingWave 内部组件。

目前 RisingWave 有以下系统参数。

参数	描述
barrier_interval_ms	周期性屏障的时间间隔。
checkpoint_frequency	指定所创建检查点的屏障数量。该值必须是正整数。
sstable_size_mb	SSTable 的目标大小。
block_size_kb	SSTable 中每个块的字节大小。
bloom_false_positive	SSTable 中布隆过滤器的误报率。
state_store	状态存储 URL。
data_directory	用于存储数据和元数据对象的远程目录。
backup_storage_url	备份远程存储的 URL。
backup_storage_directory	备份远程存储的目录。
telemetry_enabled	决定是否启用遥测。更多信息请查看遥测.
max_concurrent_creating_streaming_jobs	可同时创建的流式作业的最大数量。即可同时创建的物化视图、索引、表格 Sink 或 Source 的最大数量。
pause_on_next_bootstrap	用于调试和维护。设置为 true 将在集群重新启动时暂停所有数据源，如连接器和 DML。然后此参数将被重置为其默认值（false）。要恢复数据读取，只需运行risectl meta resume或重新启动集群。

如何查看系统参数？

使用SHOW PARAMETERS命令查看系统参数及其当前值。

是否可变一栏指的是系统运行后是否可以使用ALTER SYSTEM SET命令调整该参数。t 表示可更改，f表示不可更改。

SHOW PARAMETERS;

           名称                         |     值      | 是否可变
----------------------------------------+----------------+---------
 barrier_interval_ms                    | 1000           | f
 checkpoint_frequency                   | 10             | t
 sstable_size_mb                        | 256            | f
 block_size_kb                          | 64             | f
 bloom_false_positive                   | 0.001          | f
 state_store                            | hummock+memory | f
 data_directory                         | hummock_001    | f
 backup_storage_url                     | memory         | f
 backup_storage_directory               | backup         | f
 telemetry_enabled                      | true           | t
 max_concurrent_creating_streaming_jobs | 1              | t
 pause_on_next_bootstrap                | false          | t

如何配置系统参数？

可变参数和不可变参数的配置方式不同。

使用psql中的ALTER SYSTEM SET命令可以配置可变参数，ALTER SYSTEM SET 语句的完整句法如下：

ALTER SYSTEM SET parameter_name { TO | = } { value | 'value' | DEFAULT };

不可变参数需要在 Meta 节点的 CLI 中初始化。在启动集群之前，需要初始化 state_store和data_directory。

要在 Meta 节点的 CLI 中配置参数设置，请打开安装 RisingWave 的目录，并运行以下命令：

meta-node --<parameter_name> <value>

例如，将data_directory的设置初始化：

meta-node --data_directory "hummock_001"

note

由于 RisingWave 在不同时间点读取系统参数，不能保证参数值更改会立即生效。我们建议在启动 RisingWave 集群后、运行流式查询之前调整系统参数。