Struct SentinelPoolConfig 

pub struct SentinelPoolConfig { /* private fields */ }

Sentinel 连接池配置。

示例

use redis_sentinel_pool::SentinelPoolConfig;

let cfg = SentinelPoolConfig::new(
    vec![
        "redis://127.0.0.1:26379".to_string(),
        "redis://127.0.0.1:26380".to_string(),
        "redis://127.0.0.1:26381".to_string(),
    ],
    "mymaster",
)
.max_size(32)
.redis_password("secret");

Implementations

impl SentinelPoolConfig

pub fn new<I, S>(sentinels: I, service_name: impl Into<String>) -> Self

where I: IntoIterator<Item = S>, S: Into<String>,

创建一个新的配置。

• sentinels —— Sentinel 节点列表，形如 redis://host:port。
• service_name —— Sentinel 中配置的 master 名称，例如 mymaster。

pub fn role(self, role: ServerRole) -> Self

选择拉取的节点角色，默认 ServerRole::Master。

pub fn max_size(self, max_size: u32) -> Self

连接池最大连接数，默认 16。

pub fn min_idle(self, min_idle: u32) -> Self

最小空闲连接数（提前预热），默认不设置。

pub fn connection_timeout(self, timeout: Duration) -> Self

借连接的超时时间，默认 5 秒。

pub fn idle_timeout(self, timeout: Option<Duration>) -> Self

空闲连接最长存活时间，默认 600 秒。

pub fn max_lifetime(self, lifetime: Option<Duration>) -> Self

连接最大生命周期，默认 1800 秒。

pub fn verify_role_on_checkout(self, verify: bool) -> Self

借连接时是否额外发送 ROLE 校验当前节点仍是 master，默认 true。

关闭后只会执行 PING，可以省一次 RTT，但 failover 检测延迟会变高。

pub fn max_retries(self, retries: u32) -> Self

execute_with_retry 系列方法的最大重试次数，默认 3。

pub fn retry_backoff(self, backoff: Duration) -> Self

重试之间的退避，每次重试乘以重试次数，默认 100ms（即 100ms、200ms、300ms …）。

pub fn enable_watcher(self, enable: bool) -> Self

是否启用后台订阅 +switch-master 事件，默认开启。

pub fn watcher_reconnect_backoff(self, backoff: Duration) -> Self

watcher 断开后重连的退避，默认 2 秒。

pub fn redis_db(self, db: i64) -> Self

选择 Redis 数据库索引（注意：Sentinel 自身的连接不能使用非 0 库）。

pub fn redis_username(self, username: impl Into<String>) -> Self

Redis ACL 用户名。

pub fn redis_password(self, password: impl Into<String>) -> Self

Redis 密码。

pub fn redis_protocol(self, protocol: ProtocolVersion) -> Self

Redis 协议版本（默认 RESP2）。

pub fn redis_tls_mode(self, tls_mode: TlsMode) -> Self

Redis 节点的 TLS 模式。

Trait Implementations

impl Clone for SentinelPoolConfig

fn clone(&self) -> SentinelPoolConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SentinelPoolConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.