Configuration

redis有很多不同的方法来配置连接字符串 , StackExchange.Redis 提供了一个丰富的配置模型,当调用Connect 或者 ConnectAsync 时需要传入。

var conn = ConnectionMultiplexer.Connect(configuration);

这里的 configuration 参数可以是:

1. 一个 ConfigurationOptions 实例

2. 一个字符串

第二种方式从根本上来说也是ConfigurationOptions。

通过字符串配置连接

最简单的配置方式只需要一个主机名

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

它将会连接到本地的redis服务器 , 默认6379端口 ,多个连接通过逗号分割 。 其他选项在名称的后面包含了一个 “= ”。 例如

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

可以将一个字符串转换为ConfigurationOptions 或者 将一个ConfigurationOptions转换为字符串 。

ConfigurationOptions options = ConfigurationOptions.Parse(configString);

OR

string configString = options.ToString();

推荐的用法是将基础信息保存在一个字符串中,然后在运行是通过ConfigurationOptions改变其他信息。

string configString = GetRedisConfiguration();

var options = ConfigurationOptions.Parse(configString);

options.ClientName = GetAppName(); // only known at runtime

options.AllowAdmin = true;

conn = ConnectionMultiplexer.Connect(options);

也可以指定密码

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

 

配置选项

ConfigurationOptions 包含大量的配置选项,一些常用的配置如下:

abortConnect : 当为true时,当没有可用的服务器时则不会创建一个连接

allowAdmin : 当为true时 ,可以使用一些被认为危险的命令

channelPrefix:所有pub/sub渠道的前缀

connectRetry :重试连接的次数

connectTimeout:超时时间

configChannel: Broadcast channel name for communicating configuration changes

defaultDatabase : 默认0到-1

keepAlive : 保存x秒的活动连接

name:ClientName

password:password

proxy:代理 比如 twemproxy

resolveDns : 指定dns解析

serviceName : Not currently implemented (intended for use with sentinel)

ssl={bool} : 使用sll加密

sslHost={string} : 强制服务器使用特定的ssl标识

syncTimeout={int} : 异步超时时间

tiebreaker={string}:Key to use for selecting a server in an ambiguous master scenario

version={string} : Redis version level (useful when the server does not make this available)

writeBuffer={int} : 输出缓存区的大小

各配置项用逗号分割

自动和手动配置

在大部分的情况下StackExchange.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=

重命名命令

你可以禁用或者重命名一个命令。 按照前面的示例这是通过 CommandMap 来完成的,不过上面使用Create( new HashSet<string> )来进行配置,我们使用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