Vertica Spread 配置最佳实践¶

原文：Best Practices for Spread Configuration

概述¶

Spread 是 Vertica 集群中关键的内部通信组件，负责节点之间的控制信息交换。Spread 的配置直接影响集群的稳定性和响应速度。

Vertica 集群包含两个独立的网络通道：

控制通道（Control Channel）：使用 Spread 协议，负责节点心跳、集群成员管理、元数据同步等控制信息交换
数据通道（Data Channel）：使用 Vertica 专有协议，负责查询数据在节点间的传输

本文重点介绍控制通道中 Spread 的配置最佳实践。

Spread 架构¶

Spread 运行在集群中每个节点上，形成一个网状拓扑的通信层。所有节点通过 Spread 交换心跳信息（默认每秒一次），以此维持集群一致性视图。

Spread Architecture

当节点发现对端心跳超时时，会触发集群重组（reconfiguration）。频繁的重组会严重影响集群可用性。因此，Spread 的正确配置对集群健康至关重要。

UDP 广播模式（Broadcast）¶

UDP 广播模式是 Vertica Spread 的默认通信模式。在此模式下，每个 Spread 进程向本地子网广播消息，所有同子网的节点接收。

适用场景¶

所有 Vertica 节点位于同一个广播域（同一 VLAN/子网）
网络交换机未启用广播风暴防护，或已配置允许 Spread 广播

配置方法¶

-- 设置为广播模式（默认值）
SELECT set_control_mode('broadcast');

广播模式的优点¶

配置简单，无需指定对端列表
延迟较低，适合高性能局域网环境

UDP 点对点模式（Point-to-Point）¶

UDP 点对点模式（pt2pt）下，Spread 进程不依赖广播，而是直接向已知的对端节点发送消息。此模式在以下场景中不可替代：

适用场景¶

节点分布在多个子网（跨 VLAN/跨数据中心）
云环境（AWS、Azure、GCP 等），通常不支持广播
网络策略限制了广播包
启用了网络隔离的托管环境

配置方法¶

-- 设置为点对点模式
SELECT set_control_mode('pt2pt');

点对点模式的优点¶

不依赖广播，适用于跨子网部署
减少不必要的网络广播流量
云环境兼容性更好

Spread 日志配置¶

默认情况下，Spread 日志功能是禁用的。只有在需要排查通信问题时才建议启用，因为日志会产生大量输出。

启用 Spread 日志¶

使用 set_spread_options 函数配置 Spread 日志输出：

-- 启用 Spread 调试日志，输出到指定文件
SELECT set_spread_options('-d all -l /tmp/spread.log');

常用调试选项：

选项	说明
`-d all`	启用所有调试级别
`-l <path>`	指定日志文件路径

禁用 Spread 日志¶

排查完成后务必关闭日志，避免磁盘空间耗尽：

-- 清空 Spread 选项关闭日志
SELECT set_spread_options('');

查看和重载 Spread 配置¶

查看当前配置¶

生成当前内存中的 Spread 配置，无需查看实际配置文件：

SELECT generate_spread_config();

输出内容即为 Spread 守护进程当前使用的配置。

写入配置¶

将当前配置写入 Spread 配置文件：

SELECT write_spread_config();

重载配置¶

在不重启 Spread 进程的情况下应用配置变更：

SELECT reload_spread();

常用操作顺序：

-- 典型配置更新流程
SELECT set_control_mode('pt2pt');
SELECT write_spread_config();
SELECT reload_spread();

spread.conf 配置示例¶

广播模式¶

广播模式下的 spread.conf 典型内容：

# Vertica spread configuration
# Broadcast mode

Spread_Segment 10.0.1.0:4803 {
    node0001  10.0.1.10:4803
    node0002  10.0.1.11:4803
    node0003  10.0.1.12:4803

    # 广播端口
    Broadcast 10.0.1.255:4803
}

点对点模式¶

点对点模式下的 spread.conf 典型内容：

# Vertica spread configuration
# Point-to-point mode

Spread_Segment 10.0.1.0:4803 {
    node0001  10.0.1.10:4803
    node0002  10.0.1.11:4803
    node0003  10.0.1.12:4803
}

注意点对点模式配置中没有 Broadcast 行。每个节点的 Spread 通过已知的对端地址进行通信。

重要提醒¶

始终使用 SQL 函数，不要手动编辑 spread.conf¶

绝对不要手动编辑 spread.conf 文件。Vertica 通过集群管理工具维护此文件的一致性。手动编辑可能导致：

集群节点间配置不一致
Spread 配置在集群重组时被覆盖
节点无法加入集群
数据损坏风险

所有 Spread 配置变更必须通过 SQL 函数完成：

操作	SQL 函数
设置控制模式	`set_control_mode()`
配置 Spread 选项	`set_spread_options()`
生成配置查看	`generate_spread_config()`
写入配置文件	`write_spread_config()`
重载配置	`reload_spread()`

扩展阅读¶

本文是 Spread 配置的专项指南。关于 Spread 故障排查，可参考 Vertica 官方文档中的 Spread 调试相关章节。