StackExchange.Redis 官方文档(二) Configuration

Easter79
• 阅读 467

原文: StackExchange.Redis 官方文档(二) Configuration

配置

有多种方式可以配置redis,StackExchange.Redis提供了一个丰富的配置模型,在执行Connect (or ConnectAsync) 时被调用:

var conn = ConnectionMultiplexer.Connect(configuration);

这里的 configuration 可以是一下类型当中的任意一项:

  • 一个ConfigurationOptions 实例
  • 一个包含配置数据的字符串

后者基本上是前者的字符串形式

基本的配置字符串

最简单 的例子就是只包含主机的名称:

var conn = ConnectionMultiplexer.Connect("localhost");

这样就会链接到部署在本地机器上使用默认端口(6379)的单服务器。其余的配置选项只需要拼接在后面(要用逗号分隔).端口之前通常使用分号(:)分隔。配置 选项 在名称后边有一个=。示例:

var conn = ConnectionMultiplexer.Connect("redis0:6380,redis1:6380,allowAdmin=true");

stringConfigurationOptions之间的映射在下面有详细的概述,你可以通过如下的方式对两者进行互相转换:

ConfigurationOptions options = ConfigurationOptions.Parse(configString);

or:

string configString = options.ToString();

常用的方式将基本的配置保存在字符串当中,但运行的时候应用特殊的配置:

string configString = GetRedisConfiguration();
var options = ConfigurationOptions.Parse(configString);
options.ClientName = GetAppName(); // 只能在运行状态下才能获取到
options.AllowAdmin = true;
conn = ConnectionMultiplexer.Connect(options);

带有密码的 Microsoft Azure Redis 实例:

var conn = ConnectionMultiplexer.Connect("contoso5.redis.cache.windows.net,ssl=true,password=...");

配置选项

ConfigurationOptions对象有很多属性,转换时会自动判断。下面是一些常用的配置:

Configuration string

ConfigurationOptions

Meaning

abortConnect={bool}

AbortOnConnectFail

如果是true,Connect方法在链接不到有效的服务器的时候不会创建一个链接实例

allowAdmin={bool}

AllowAdmin

启用被认定为是有风险的一些命令

channelPrefix={string}

ChannelPrefix

所有的发布订阅频道的前缀

connectRetry={int}

ConnectRetry

在初始化 Connect 失败的时候重新尝试进行链接的次数

connectTimeout={int}

ConnectTimeout

链接超时时间(ms)

configChannel={string}

ConfigurationChannel

用于传递配置改变信息的广播频道

defaultDatabase={int}

DefaultDatabase

默认的数据库序数,从1到-1

keepAlive={int}

KeepAlive

发送信息以保持sockets在线的间隔时间

name={string}

ClientName

在redis内用于判别不同链接客户端

password={string}

Password

密码

proxy={proxy type}

Proxy

代理类型(如果有的话); 如 "twemproxy"

resolveDns={bool}

ResolveDns

指定DNS解析服务器, 推荐明确指出,而不是采用默认的

serviceName={string}

ServiceName

当前没有实现(用于sentinel模式)

ssl={bool}

Ssl

使用SSL加密

sslHost={string}

SslHost

在服务器证书上注册SSL主机身份标识

syncTimeout={int}

SyncTimeout

同步操作的超时时间(ms)

tiebreaker={string}

TieBreaker

多主机服务器部署情形下中用于选择出master服务的Key

version={string}

DefaultVersion

Redis版本(用于从服务器获取不到此信息时)

writeBuffer={int}

WriteBuffer

输出缓存大小

配置字符串的Token是用逗号分隔开的;任何没有 = 符号的Token都会被认为是一个服务器节点。节点信息如果没有指出端口号在没有使用ssl的情况下会默认为6379,启用了ssl则默认使用6380。
Token当中如果是以$开头则表示是命令映射信息,例如:$config=cfg

自动配置和手动配置

在通常的方案当中,StackExchange.Redis 会自动配置很多设置,包括服务器类型和版本,链接超时时间,以及主从关系。但是,有时候这些命令会被redis服务器无效化,这种情况下,提供这些信息是很有必要的:

ConfigurationOptions config = new ConfigurationOptions
{
    EndPoints =
    {
        { "redis0", 6379 },
        { "redis1", 6380 }
    },
    CommandMap = CommandMap.Create(new HashSet<string>
    { // EXCLUDE a few commands
        "INFO", "CONFIG", "CLUSTER",
        "PING", "ECHO", "CLIENT"
    }, available: false),
    KeepAlive = 180,
    DefaultVersion = new Version(2, 8, 8),
    Password = "changeme"
};

或者使用下面字符串的方式:

redis0:6379,redis1:6380,keepAlive=180,version=2.8.8,$CLIENT=,$CLUSTER=,$CONFIG=,$ECHO=,$INFO=,$PING=

命令重命名

redis里有一个不常用的功能,就是禁用或者重命名个别的命令。在这之前的每一个例子,这个功能是通过CommandMap操作的,但是它并没有采用传参数HashSet<string>或者 Create()的形式(去明确指出哪些命令可用哪些命令不可用),而是采用 Dictionary<string,string>的形式。这个字典当中包含的所有的命令都被假定为启用,而且并没有被重命名。 null或者空字符串则表示命令被禁用了,例如:

var commands = new Dictionary<string,string> {
        { "info", null }, // disabled
        { "select", "use" }, // renamed to SQL equivalent for some reason
};
var options = new ConfigurationOptions {
    // ...
    CommandMap = CommandMap.Create(commands),
    // ...
}

字符串形式:

$INFO=,$SELECT=use

Twemproxy

Twemproxy是一个可以把多个服务器当成一个服务器的工具,带有分享和容错能力(这和redis cluster很相似,但是实现方式不同)。Twemproxy可以使用的功能是简化过的。为了避免手动配置,可以使用Proxy配置项:

var options = new ConfigurationOptions
{
    EndPoints = { "my-server" },
    Proxy = Proxy.Twemproxy
};

Tiebreakers和配置更改公告

正常情况下StackExchange.Redis会自动判别主从节点。但是,如果你没有使用类似于redis-sentinel或者redis cluster的管理工具,你可能会碰到有多个master节点的情况(例如,维护时重置了节点,在网络中在就表现为是一个master)。为了解决这种情况,StackExchange.Redis使用了_tie-breaker_的概念 - 他只有在检测到多个master的时候才会用到。(不包括redis cluster的情况下,因为redis cluster是正是需要多个master的)。为了兼容BookSleeve,默认的key是"__Booksleeve_TieBreak"(只存在于0号数据库)。他是一种原始的投票机制去判断更适用的master。(so that work is routed correctly.)

类似的,当配置发生改变时(特别是master/slave配置),让已经链接的实例知道新的环境(通过INFO, CONFIG等可以使用的命令)是很重要的。StackExchagnge.Redist通过自动订阅一个pub/sub频道,这个频道是用来发送这些通知的。为了兼容BookSleeve,频道名名称默认是 "__Booksleeve_MasterChanged"

这两个选项都是可以通过.ConfigurationChannel.TieBreaker配置属性自定义或者禁用的(设置为"")。

这些设置也可以被IServer.MakeMaster()方法使用,来设置数据库里的tie-breaker以及广播配置更改消息。对于master/slave变化的配置信息也可以通过 ConnectionMultiplexer.PublishReconfigure 方法来请求所有节点刷新配置。

原文地址StackExchange.Redis
大部分为意译,如有不当还请指正

点赞
收藏
评论区
推荐文章
秃头王路飞 秃头王路飞
5个月前
webpack5手撸vue2脚手架
webpack5手撸vue相信工作个12年的小伙伴们在面试的时候多多少少怕被问到关于webpack方面的知识,本菜鸟最近闲来无事,就尝试了手撸了下vue2的脚手架,第一次发帖实在是没有经验,望海涵。languageJavaScript"name":"vuecliversion2","version":"1.0.0","desc
blmius blmius
1年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
技术小男生 技术小男生
5个月前
linux环境jdk环境变量配置
1:编辑系统配置文件vi/etc/profile2:按字母键i进入编辑模式,在最底部添加内容:JAVAHOME/opt/jdk1.8.0152CLASSPATH.:$JAVAHOME/lib/dt.jar:$JAVAHOME/lib/tools.jarPATH$JAVAHOME/bin:$PATH3:生效配置
光头强的博客 光头强的博客
5个月前
Java面向对象试题
1、请创建一个Animal动物类,要求有方法eat()方法,方法输出一条语句“吃东西”。创建一个接口A,接口里有一个抽象方法fly()。创建一个Bird类继承Animal类并实现接口A里的方法输出一条有语句“鸟儿飞翔”,重写eat()方法输出一条语句“鸟儿吃虫”。在Test类中向上转型创建b对象,调用eat方法。然后向下转型调用eat()方
刚刚好 刚刚好
5个月前
css问题
1、在IOS中图片不显示(给图片加了圆角或者img没有父级)<div<imgsrc""/</divdiv{width:20px;height:20px;borderradius:20px;overflow:h
小森森 小森森
5个月前
校园表白墙微信小程序V1.0 SayLove -基于微信云开发-一键快速搭建,开箱即用
后续会继续更新,敬请期待2.0全新版本欢迎添加左边的微信一起探讨!项目地址:(https://www.aliyun.com/activity/daily/bestoffer?userCodesskuuw5n)\2.Bug修复更新日历2.情侣脸功能大家不要使用了,现在阿里云的接口已经要收费了(土豪请随意),\\和注意
晴空闲云 晴空闲云
5个月前
css中box-sizing解放盒子实际宽高计算
我们知道传统的盒子模型,如果增加内边距padding和边框border,那么会撑大整个盒子,造成盒子的宽度不好计算,在实务中特别不方便。boxsizing可以设置盒模型的方式,可以很好的设置固定宽高的盒模型。盒子宽高计算假如我们设置如下盒子:宽度和高度均为200px,那么这会这个盒子实际的宽高就都是200px。但是当我们设置这个盒子的边框和内间距的时候,那
艾木酱 艾木酱
5个月前
快速入门|使用MemFire Cloud构建React Native应用程序
MemFireCloud是一款提供云数据库,用户可以创建云数据库,并对数据库进行管理,还可以对数据库进行备份操作。它还提供后端即服务,用户可以在1分钟内新建一个应用,使用自动生成的API和SDK,访问云数据库、对象存储、用户认证与授权等功能,可专
Stella981 Stella981
1年前
KVM调整cpu和内存
一.修改kvm虚拟机的配置1、virsheditcentos7找到“memory”和“vcpu”标签,将<namecentos7</name<uuid2220a6d1a36a4fbb8523e078b3dfe795</uuid
Wesley13 Wesley13
1年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
helloworld_28799839 helloworld_28799839
5个月前
常用知识整理
Javascript判断对象是否为空jsObject.keys(myObject).length0经常使用的三元运算我们经常遇到处理表格列状态字段如status的时候可以用到vue