原文:StackExchange.Redis 官方文档(五) Keys, Values and Channels

Keys, Values and Channels

在使用redis的过程中,要注意到 keyeverthing else 有很大不同.一个key是在同一个数据库当中一个数据片段(可能是String、List、Hash,或者其他的redis数据类型)所特有的名称。key并不会被执行。进一步来说,在使用集群或者其他的分片系统时,key定义了哪一个节点存储了这个数据。所以key对于 routing command 是很重要的

而 value 有很大的不同:value是key对应的存储的数据 - 也许是一个独立的数据(像 String 数据),也许是多个value组成的一个群体。value不会影响routing command(注意:除了 SORT 命令,并且指定了 BY or GET 参数,其中的逻辑很难去解释).相对应的是 value 经常被redis作为操作的目标来解释执行:

  • incr (和其他几个相似的命令) 将 String 类型的 value 作为数据类型来执行
  • 排序(使用数据 或者 unicode的排序规则)
  • 其他

关键点是api需要理解什么是key和什么是value。这在 StackExchange.Redis Api 中得到充分的表现,但是好消息是在大部分情况下你根本不需要知道它是什么。

在使用 pub/sub时,我们会使用到 channels:channel不会影响routing command (所以它们并不是key),但是和通常value也有很大的不同,所有它们被单独进行处理。

Keys

StackExchange.Redis 使用RedisKey代表key的类型.他会把在stringbyte[]类型之间进行隐式的转换,从而允许使用字符串和二进制数据作为key,避免复杂化。举个例子来说,StringIncrement方法使用RedisKey作为第一个参数,但是你根本不需要知道它是需要什么类型的,例:

string key = ...
db.StringIncrement(key);

or

byte[] key = ...
db.StringIncrement(key);

同时,它会在某些操作返回的key作为 RedisKey

string someKey = db.KeyRandom();

Values

StackExchange.Redis 使用RedisValue类型作为值的类型.正如RedisKey,这些转换都是在隐式进行的,所以在大部分时间,你都不会看到这个数据类型,例:

db.StringSet("mykey", "myvalue");

除了字符串和二进制的数据,value支持.net中大部分的原始数据类型 Int32, Int64, Double or Boolean:

db.StringSet("mykey", 123); // this is still a RedisKey and RedisValue
...
int i = (int)db.StringGet("mykey");

注意:从原始数据类型到RedisValue类型是隐式的,但是从RedisValue转换到原始数据类型是显示的:这是以为数据在没有合适的值的时候转换会失败。

注意:在操作数值类型时,redis会把不存在的key的值作为0处理;为了保持一致性,nil返回值将会认为0值:

db.KeyDelete("abc");
int i = (int)db.StringGet("abc"); // this is ZERO

如果你要检测nil的情况,你可以使用下面的方法:

db.KeyDelete("abc");
var value = db.StringGet("abc");
bool isNil = value.IsNull; // this is true

或者更简单点,使用Nullable<T>

db.KeyDelete("abc");
var value = (int?)db.StringGet("abc"); // behaves as you would expect

Hashes

field的名称不是key,数据类型可以是字符串或者是二进制;所以,在api中它们被当作value来处理。

Channels

pub/sub的频道名称是 RedisChannel类型

Scripting

Lua scripting in redis 有两个显著的特点:

  • 输入必须将key和value分开 (在script中各自将会变成 KEYS and ARGV)
  • 返回的格式没有预先定义的,不同的脚本可能有不同的格式

因此,ScriptEvaluate方法接受两个分开的参数数组: RedisKey[]RedisValue[](两个都是可选的,如果省略将会认为空),这可能是少数几种需要指定RedisKey或者RedisValue类型的情况之一:

var result = db.ScriptEvaluate(TransferScript,
new RedisKey[] { from, to }, new RedisValue[] { quantity });

(TransferScript是包含Lua加班呢的string,这里将不做展示)

返回类型RedisResult(对于脚本所特有的:通常api将会尽可能直接和清楚的表示返回结果)。之前,RedisResult提供了一系列的转换操作-比RedisValue更多:

string[] items = db.ScriptEvaluate(...);

总结

api中用到的数据类型都是用来区分 从keyvalue 而精挑细选出来的。但是,实际情况中你并不会直接接触这些类型。

StackExchange.Redis 官方文档(五) Keys, Values and Channels的更多相关文章

  1. StackExchange.Redis 官方文档

    原文:StackExchange.Redis 官方文档 时隔多年的翻译终于完成了第六个,也是很重要的的官方文档,是介绍有关链接管理,管道流水线和多路复用的 官方地址在这里:官方文档 下面做个汇总: S ...

  2. StackExchange.Redis 官方文档(六) PipelinesMultiplexers

    原文:StackExchange.Redis 官方文档(六) PipelinesMultiplexers 流水线和复用 糟糕的时间浪费.现代的计算机以惊人的速度产生大量的数据,而且高速网络通道(通常在 ...

  3. StackExchange.Redis 官方文档(四) KeysScan

    KEYS, SCAN, FLUSHDB 方法在哪? 经常有人问这些问题: 好像并没有看到 Keys(...) 或者 Scan(...)方法?那我要怎么查询数据库里面存有哪些key? 或者 好像没有Fl ...

  4. StackExchange.Redis 官方文档(一) Basics

    基本使用方法: StackExchange.Redis的核心是 StackExchange.Redis 命名空间的 ConnectionMultiplexer 类;它隐藏了多服务器的实现细节.Conn ...

  5. StackExchange.Redis 官方文档(三) Events

    事件 ConnectionMultiplexer类型提供了很多可以用来了解表面状态下正在发生着什么的事件.这对日志是很有用的. ConfigurationChanged - ConnectionMul ...

  6. StackExchange.Redis 官方文档(二) Configuration

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

  7. Redis官方文档》持久化

    原文链接 译者:Alexandar Mahone 这篇文章从技术层面描述了Redis持久化,建议所有读者阅读.如果希望更多了解Redis持久化和持久性保障,建议阅读Redis持久化揭秘. Redis ...

  8. Redis官方文档资源

    官方文档: 如果要深入研究时,官方提供的文档是最权威的. 英文: https://redis.io/documentation 中文: http://www.redis.cn/documentatio ...

  9. 《Redis官方文档》用Redis构建分布式锁

    用Redis构建分布式锁 在不同进程需要互斥地访问共享资源时,分布式锁是一种非常有用的技术手段. 有很多三方库和文章描述如何用Redis实现一个分布式锁管理器,但是这些库实现的方式差别很大,而且很多简 ...

随机推荐

  1. hdu 5375 - Gray code(dp) 解题报告

    Gray code Time Limit: 2000/1000 MS (Java/Others)    Memory Limit: 65536/65536 K (Java/Others) Total ...

  2. 配置Lotus Domino集群视频详解

    IBM Lotus Domino Server 有个最重要的高可用特新就是集群,它对于任何使用 Domino 服务器的组织,让用户能够持续访问它们的数据库,保证业务不间断运行.下面通过两个视频来学习如 ...

  3. Think Pad笔记本分区解决思路及方法

    Think pad笔记本分区解决思路及方法       近日好友拿着新买的Thinkpad X300过来找我,说这个笔记本只有一个分区,所有的东西不得放在C盘,希望再多分出几个分区.抱怨原先在wind ...

  4. Kinect 开发 —— 控制PPT播放

    实现Kinect控制幻灯片播放很简单,主要思路是:使用Kinect捕捉人体动作,然后根据识别出来的动作向系统发出点击向前,向后按键的事件,从而使得幻灯片能够切换. 这里的核心功能在于手势的识别,我们在 ...

  5. 2017国家集训队作业[agc014d]Black and White Tree

    2017国家集训队作业[agc014d]Black and White Tree 题意: ​ 有一颗n个点的树,刚开始每个点都没有颜色.Alice和Bob会轮流对这棵树的一个点涂色,Alice涂白,B ...

  6. 用css让元素隐藏的几种办法

    display:none;   //能隐藏并不占空间 visibility:hidden;  //隐藏但占据空间 opacity:0; position:absolute 移动到不在页面显示的地方

  7. 03006_DOS操作数据乱码解决

    1.我们在dos命令行操作中文时,会报错 insert into sort(sid,sname) values(2,"电视机"); ERROR 1366 (HY000): Inco ...

  8. JNDI学习总结(1)——JNDI入门

    JNDI是 Java 命名与目录接口(Java Naming and Directory Interface),在J2EE规范中是重要的规范之一,不少专家认为,没有透彻理解JNDI的意义和作用,就没有 ...

  9. Axios再记录

    一个基于Promise 用于浏览器和 nodejs 的 HTTP 客户端(可实现ajax的请求) 有关学习网址:https://www.tuicool.com/articles/eMb2yuY    ...

  10. Maven实战(五)——自己主动化Web应用集成測试

    自己主动化集成測试的角色 本专栏的上一篇文章讲述了Maven与持续集成的一些关系及详细实践,我们都知道,自己主动化測试是持续集成不可缺少的一部分,基本上,没有自己主动化測试的持续集成,都非常难称之为真 ...