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");
string
和ConfigurationOptions
之间的映射在下面有详细的概述,你可以通过如下的方式对两者进行互相转换:
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
大部分为意译,如有不当还请指正
转载于:https://www.cnblogs.com/ArvinZhao/p/6007043.html
StackExchange.Redis 官方文档(二) Configuration相关推荐
- StackExchange.Redis 官方文档(五) Keys, Values and Channels
StackExchange.Redis 官方文档(五) Keys, Values and Channels 原文:StackExchange.Redis 官方文档(五) Keys, Values an ...
- StackExchange.Redis官方文档(四)【键、值以及通道】
键.值以及通道 在对待Redis时候,键和其他的事物之间有个相当重要的区别.键是在数据库中一段数据的唯一标识(可能String,List,Hash或者其他的Redis数据类型).键是没有任何实质意义, ...
- StackExchange.Redis 官方文档(六) PipelinesMultiplexers
流水线和复用 糟糕的时间浪费.现代的计算机以惊人的速度产生大量的数据,而且高速网络通道(通常在重要的服务器之间同时存在多个链路)提供了很高的带宽,但是计算机花费了大量的时间在 等待数据 上面,这也是造 ...
- StackExchange.Redis官方文档(一)【基本用法】
基本用法 ConnectionMultiplexer 类是StackExchange.Redis的中枢对象,它在StackExchange.Redis名称空间中: 这个对象封装了很多基础服务对象的详细 ...
- 《Redis官方文档》用Redis构建分布式锁
<Redis官方文档>用Redis构建分布式锁 用Redis构建分布式锁 在不同进程需要互斥地访问共享资源时,分布式锁是一种非常有用的技术手段. 有很多三方库和文章描述如何用Redis实现 ...
- Redis官方文档(入门必备)
函数大全 中文文档 官方文档
- Unity 优化翻译官方文档(二) ------ 平台特定覆盖的纹理压缩格式
官方文档 : https://docs.unity3d.com/Manual/class-TextureImporterOverride.html 虽然Unity支持许多常见的图像格式作为导入纹理的源 ...
- Redis 官方文档阅读之 High Availability
文章目录 Distributed nature of Sentinel(sentinel的分布式特性) Quick Start Obtaining Sentinel(获取哨兵) Running Sen ...
- 《Redis官方文档》Redis调试指南
原文链接 译者:Adeline Redis开发过程中十分注重其稳定性:我们尽一切努力来保证每一个版本的稳定,不出现突然崩溃等情况.但是即使在我们百分百的努力下,仍然没办法保证百分百的无bug ...
最新文章
- Mysql中文乱码问题完美解决方案
- 员工管理系统---SpringBoot
- Java-Scanner进阶使用
- 【Hadoop】Hadoop SocketChannelImpl UnresolvedAddressException
- Ping 命令完全讲解
- Python 矩形法求1/x的定积分(完美实现)
- ERP、SCM、CRM的区别和联系
- Python中._pth文件的作用
- 饮水机和水桶图解RAID方式,强烈推荐
- layout-v21透明主题不生效的bug
- TK1+yolo安装指南
- android 设计师是处女座的,处女座速成法!设计师的像素眼是怎样炼成的?
- 【OpenCV】 - 图像分割之分水岭算法,watershed()函数的输出,对marker和image的改变
- 2.牛批了 Android 2021中高级面试题 一线大厂和二线大厂面试真题精选 (京东 附答案)第二套 22k+
- 关于手机店、电脑城,存在的物联卡的情况说明
- 机器学习实战之决策树(一)构造决策树
- ubuntu/linux安装Atom
- B860AV3.1-M2_刷机固件
- Android传感器Motion Sensor开发实验
- 设计c语言程序得到回文数,C语言程序设计实训题目.pdf
热门文章
- 《Linux内核设计与实现》读书笔记(十七)- 设备与模块
- Linux嵌入式 -- Bootloader , Uboot
- HDU Problem - 4292 Food(最大流, 建边)
- 字符串相乘(大数相乘)
- einops包中的rearrange,reduce, repeat及einops.layers.torch中的Rearrange,Reduce。对高维数据的处理方式
- 利用tensorflow建立简单的神经网络所需要的几条简单语句
- HTML <!DOCTYPE> 标签
- shell多行匹配如何实现
- eclipse 设置working directory
- 2-hadoop-Hadoop以及生态