# 配置DWS快照参数
快照参数配置可以指定创建快照和快照恢复的参数信息，以便对快照功能进行优化调整。
#### 约束与限制
- 该功能仅8.2.0及以上集群版本支持（对于8.2.0之前的集群版本，仅支持个别参数的配置）。
- 配置参数后该集群所有的快照、恢复都将以所配置的参数下发命令。
- 9.1.0.210及以上集群版本新增支持thread-count配置，Roach启动多线程备份冷热表和v3表时，使用的并发线程数，默认为cpu核数的2倍。
- Roach插件版本不低于1.5.3的集群快照恢复参数和集群参数合并，单击**"参数配置"** 将自动跳转至集群**"参数修改"**页签修改相关备份恢复参数（升级Roach插件请联系技术支持工程师）。
 
#### 操作步骤
1. [登录DWS管理控制台](https://console.huaweicloud.com/dws)。
2. 在左侧导航栏中，选择**"集群 \> 集群列表"**。
3. 在集群列表中，单击指定集群的名称，进入**"集群详情"**页面。
4. 切换至**"快照"** 页签，再单击二级页签中的**"参数配置"** 。在**"参数配置"**页面，会展示当前集群所有的可配参数。
5. 根据用户不同的参数要求填入合适的参数值，详情请参见[表1]。
   
   
   ![](https://support.huaweicloud.com/mgtg-dws/figure/zh-cn_image_0000002587065722.png "点击放大")
   
   
6. 单击"保存"即可。
 
#### 快照参数详情
 表1快照参数说明 
| 参数名称               | 参数类型   | 参数描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 默认值                                   |
|:---|:---|:---|:---|
| parallel-process    | 备份参数  | 指定Roach备份时每个节点的并发进程。该参数支持8.2.0之前版本集群配置。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 为本节点主DN个数                              |
| compression-type    | 备份参数  | 压缩算法类型：该参数支持8.2.0之前版本集群配置。 - zlib  - LZ4                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | LZ4                                   |
| compression-level   | 备份参数  | 压缩级别，取值范围为0\~9，该参数支持8.2.0之前版本集群配置。 - 0代表快速或无压缩。  - 9代表慢速或最大压缩。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 6                                    |
| buffer-size        | 备份参数  | 指定Roach上传介质的buffer大小，取值范围为256\~16384，单位：兆字节。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 256                                     |
| buffer-block-size    | 备份参数   | 指定Roach读取数据文件的数据块大小，取值范围为5242880\~268435456，单位：字节。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 67108864                               |
| cpu-cores          | 备份参数  | Roach启动多线程并发时，可以使用的CPU核数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 为节点CPU逻辑核数总和的1/2                      |
| master-timeout        | 备份参数   | 指定Roach master节点和agent节点的通信超时时间，取值范围为600\~3600，单位：秒。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 3600                                 |
| max-backup-io-speed | 备份参数   | 指定Roach备份时的IO流控，取值范围为0\~2048，单位：兆字节/秒。必须大于buffer-block-size，0表示不限制。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 0                                      |
| backup-mode       | 备份参数    | 全量备份的模式： - 0 ：一阶段的备份  - 1 ：两阶段的备份                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | 0                                    |
| cbm-parse-mode    | 备份参数  | 增量备份的模式： - 0 ：一次扫描cbm（内存占用大，性能快）  - 1 ：多次扫描cbm（内存占用稳定，性能差）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 0                                    |
| thread-count        | 备份参数   | Roach启动多线程备份冷热表和v3表时，使用的并发线程数。如果用户该参数配置过高，可能会影响到正常业务对OBS的访问，请谨慎取值。该参数仅9.1.0.210及以上集群版本支持配置。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 4                                      |
| dump-options       | 备份参数  | 指定细粒度备份时支持的备份选项，支持备份权限和注释。该参数仅9.1.0及以上集群版本支持配置。 - 权限：enable_handle_acl。  - 注释：enable_handle_comment。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 不备份权限和注释                              |
| logging-level         | 备份参数   | 指定备份的日志级别： - FATAL（致命）：导致系统停止工作的、无法恢复的故障。该级别为最严重级别。  - ERROR（错误）：重大错误。  - WARNING（警告）：异常情况。系统在该情况下可能会继续处理任务。  - INFO（提示）：日志记录过程中的提示性日志。  - DEBUG（调试）：用于调试的详细信息。  - DEBUG2（调试2）：最详细的日志信息，通常会过滤不显示。该级别严重程度最轻。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | FATAL、ERROR、WARNING、INFO、DEBUG、DEBUG2 |
| parallel-process    | 恢复参数   | 指定Roach备份时每个节点的并发进程，默认当前节点主DN数 + 1。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 1                                      |
| cpu-cores           | 恢复参数   | Roach启动多线程并发时，可以使用的CPU核数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 默认是CPU核数的1/2                          |
| logging-level      | 恢复参数    | 日志级别： - FATAL（致命）：导致系统停止工作的、无法恢复的故障。该级别为最严重级别。  - ERROR（错误）：重大错误。  - WARNING（警告）：异常情况。系统在该情况下可能会继续处理任务。  - INFO（提示）：日志记录过程中的提示性日志。  - DEBUG（调试）：用于调试的详细信息。  - DEBUG2（调试2）：最详细的日志信息，通常会过滤不显示。该级别严重程度最轻。   | INFO                                  |
| restore-by-insert   | 恢复参数  | 该参数用于指定细粒度恢复时使用的方式。当发起细粒度恢复时携带该参数，则使用INSERT命令恢复目标表；否则，使用ALTER命令恢复目标表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | ALTER                                 |
| thread-count        | 恢复参数 | Roach启动多线程恢复冷热表和v3表时，使用的并发线程数。如果用户该参数配置过高，可能会影响到正常业务对OBS的访问，请谨慎取值。该参数仅9.1.0.210及以上集群版本支持配置。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 4                                     |
| dump-options        | 恢复参数  | 指定细粒度恢复时支持的恢复选项，支持恢复权限和注释。依赖快照dump-options备份参数配置。该参数仅9.1.0及以上集群版本支持配置。 - 权限：enable_handle_acl。  - 注释：enable_handle_comment。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 不恢复权限和注释                                |
   
