免费下载案例集|20+数字化领先企业人才培养实践经验 了解详情
写点什么

5 个步骤构建优质 Redis 模块

  • 2020-03-01
  • 本文字数:2515 字

    阅读完需:约 8 分钟

5个步骤构建优质Redis模块

编写 Redis 模块时,请牢记以下五个步骤。虽然这份清单并不详尽,但是如果你还没有太多的模块构建经验,我还是能为你提供一个很好的入门方法的。

1、确定一个有吸引力的模块用例

Redis 有大量的工具可以让你构建所需的解决方案。一个例子就是锁。通过将 SET 与 NX 选项一起使用,你可以创建一个锁的 key,并将其与 EXPIRE 结合使用,即可得到一个锁租约。这在解决协调一致问题时非常有用。当内置命令还不够用时,你还可以使用 Lua 脚本,这些脚本为复合操作添加了完全的可编程性,然后由 Redis 原子地执行这些操作。


与 Lua 相比,模块在访问低层次 API 的能力方面,具有更大的灵活性和更快的速度,但是它们在维护和分发方面更具挑战性。仅在 Lua 不能完全适用你的用例时才使用模块。


模块可以添加新的命令


模块可以使用 C 语言向 Redis 添加新的命令(确切地说,你也可以使用 Rust,Zig 或任何 C-ABI 兼容语言)。你在功能上做什么取决于你自己。可以从实现与现有命令相似但可以有更多功能的命令开始。SETNE(由用户在此 GitHub Pull Request 中首次提到)就是一个示例。SETNE 的行为与 SET 完全相同,但是当新值等于当前值时,它不会修改键值,从而避免产生假的键空间通知。通常,要进行一些练习,可以考虑对现有命令添加一些附加功能,以帮助处理特定的用例。


大多数这些小的附加功能最好使用 Lua 脚本来实现,如果你刚开始想不出有吸引力的模块,这将是一种好方式。留给读者的几个练习:SETEQ,HINCRDATEBY。


模块可以添加新的数据类型


模块向 Redis 添加功能的最有效方法是添加新的数据类型。Redis 非常注重数据结构及其相关算法和属性的设计。尽管你可能不知道 Set 数据类型具体是怎么实现的,但是你肯定知道 SISMEMBER 命令执行很快,却与 Set 大小无关(例如,它具有亚线性渐近复杂度)。| 有关 BigO /渐近复杂度和 Redis 数据类型的重要性的介绍,请查看 Rob Conery 的演讲:https://www.youtube.com/watch?v=znYgNXN98Ag


这是我们自己的模块背后的基础:


•RediSearch 是基于倒排索引的全文本搜索模块。


•RedisGraph 是基于稀疏矩阵的图形模块。


•RedisTimeSeries 与 Redis Streams 类似,但针对数字序列进行了优化。


•RedisBloom 提供了一些不同的概率数据结构。


•RedisAI 运行 Tensorflow 深度学习图(以及其他一些类型)。


这些是很重要的模块,但并不是每个引入新数据类型的模块都必须如此复杂。有许多更简单的数据类型可用作模块。一个基本的示例就是 Redis 中已经存在的数据类型的不同实现,例如,使用 ArrayList 实现 List。

2、完善你的 API

不要忘记模块命令的错误用法与正确用法一样重要。Redis 用户喜欢手动调试命令以获得更好的理解,并且会输入一些错误的参数。你的 API 应该易于使用且难以滥用,但是当不可避免的情况出现时,请确保输出的错误信息是有意义的。


查看 Redis 的标准命令是如何工作的,然后看看执行你自己的命令得到的结果是否符合相应的假设。这将减少使用命令所需的心理负担。一个例子是,在 Redis 中,当调用一个不存在的键时,大多数命令都有合理的行为:INCR 会假定缺少的键值为 0,因此它会将其设置为 1,SADD 会假定缺少的键是空键,依此类推。

3、做一个好公民

模块需要可以与 Redis 生态进行交互。确保阅读文档以了解如何正确获取详细信息,尤其是当你的模块实现了新的数据类型时。这是两个最重要的方面。


命令标志


声明新的命令时,必须指定一些标志来告诉 Redis 调用命令时将要执行的操作。它是要读取数据还是要写入数据?是分配内存还是只是修改现有的数据?确保正确填写这些选项。例如,在内存不足(OOM)的情况下,deny-oom 是一个重要标志,它将告诉 Redis 拒绝访问分配内存的命令,否则整个进程将被 OOM 杀掉!即使是只读标志也很重要。新的客户端缓存功能将使用它来决定是否启用对给定 key 的跟踪。


命令复制


当 Redis 是主从模式时,主服务器必须知道应该将哪些命令发送给从服务器。并非每个命令都应复制,某些命令可能仅在特定条件下才需要复制。例如,我上面提到的 SETNE 命令,该命令仅在新值与当前值不同时才设置 key 和 value(否则它什么也不做)。在这种情况下,仅当命令有效地对 key 进行更改时,才应复制该命令。如果没有执行任何写操作,就不用让每个从服务器都执行该命令。

4、撰写出色的文档

如果你的模块都没有人知道如何使用,那么无论它多么有用都没有意义。因此完善 API 文档会有很大帮助,至少你首先得说服潜在用户该模块是值得尝试的。一个好的模块应该具有好的文档,这些文档可以明确该模块的总体目标并列出每个命令的详细信息。


如果看一下 redis.io,你就会发现每个命令都列出了其相对的 BigO 复杂性,并在命令具有特别大或小的常量或有明显边界情况时提供了一些额外的说明。尝试模仿这样的格式,尤其是在命令示例的语法方面。请注意,每个示例都是用小写字母命名占位符,大写字母表示关键字,方括号之间是可选值。查看 SET 的文档https://redis.io/commands/set 以查看此示例。


最重要的是:力求简单


始终牢记,Redis 背后的第一个设计原则是简单。这并不是说你的模块就只有这一种选择,偶尔还是可以为了其他好处而牺牲这种简单性(模块的存在正是为了让 Redis 用户体验),但要时刻注意你所放弃的东西。


一般而言,当你为了方便使用而牺牲了简单性时,也隐含地限制了用户使用模块的方式。在 Redis 中,大多数程序并不是单独使用某个命令,而是将不同的命令组合在一起使用。更小,更清晰,更简单的命令会更易于组合,因此在整体方案中会产生更好的效果。因此,我建议在进行这种权衡之前,通过适当地应用上述技术来提高易用性。


另一个潜在的权衡取舍可能是执行效率。这可能值得探索,也是 Redis 偶尔做的一个。某些内置数据类型具有两种内部的优化方式:一种是在数据类型中只有几个元素时进行优化,另一种针对 key 增长超过某个阈值时进行优化。两种方式(加上在两种方式之间进行切换的机制)肯定比只有一种方式更为复杂,但是这样做是值得的。因为增加的复杂性不会显示在用户界面中,无论使用哪种内部优化的方式,用户都将以相同的方式与数据类型进行交互。


本文转载自 中间件小哥 公众号。


原文链接:https://mp.weixin.qq.com/s/x6WTI25xBeFhdqSv65ph0Q


2020-03-01 21:421217

评论

发布
暂无评论
发现更多内容

Python 抽奖程序限定次数详解

霍格沃兹测试开发学社

华为云开源邀您共赴华为开发者大会2024,精彩议题抢先看

华为云开源

华为云开源 华为开发者大会2024

PikiwiDB(Pika) 混合存储之批量查询

apache/dubbo-go

redis Pika

深入解析Nginx配置文件

霍格沃兹测试开发学社

AI也懂区块链接

dappweb

ao

周末见!RTE Open Day@AGI Playground 游园攻略

声网

区块链市场新动向:跨链、DeFi、NFT引领未来趋势

dappweb

ao

MySQL 查询数据库响应时长详解

霍格沃兹测试开发学社

性能分析系统级别指标详解:IO、CPU、内存和网络

霍格沃兹测试开发学社

使用Playwright进行键盘操作的详细指南

霍格沃兹测试开发学社

数字文盲:我们如何在数字时代中避免被边缘化?

dappweb

ao

边缘计算的崛起

dappweb

边缘计算 ao

前端必备的几个vscode插件

大师兄

前端 vscode vscode插件 前端常用插件

律所优选管理软件排名:Alpha法律智能操作系统领先行业

科技汇

搭建服务端性能监控系统 Prometheus 详细指南

霍格沃兹测试开发学社

什么是iPaaS?

RestCloud

数字化转型 数据集成 ipaas

搭建数据分析系统 Grafana 详细指南

霍格沃兹测试开发学社

如何解决虚拟仿真教学中的设备限制和卡顿问题?|点量云流技术解决方案

点量实时云渲染

WebGL 虚拟仿真 实时云渲染 实时渲染云虚拟仿真 虚拟仿真教学

云桌面系统的运用优势有哪些?

青椒云云电脑

云桌面 云桌面系统 虚拟云桌面系统

区块链技术在金融领域的七大应用

dappweb

区块链 ao

AI与区块连接技术的联系

dappweb

ao

开个技术外挂|数字孪生技术如何成为美洲杯帆船赛成功的关键?

Altair RapidMiner

人工智能 数据分析 数字孪生 仿真

Python 遍历文件每一行判断是否只有一个换行符详解

霍格沃兹测试开发学社

云桌面GPU技术方案

青椒云云电脑

云桌面 云桌面方案

《区块链:金融服务的未来之路,去中心化引领变革》

dappweb

区块链 ao

前端项目如何规范文件命名

伤感汤姆布利柏

如何制定测试团队的绩效考核

老张

团队管理 OKR KPI 绩效考核

图形工作站的应用,相比传统工作站优势有哪些?

青椒云云电脑

图形工作站 移动图形工作站

区块链技术:揭秘五大颠覆性应用场景

dappweb

区块链 ao

DeFi浪潮中的领航者:探索DeFi市场最受欢迎的创新项目

dappweb

ao

区块链技术:产业转型的革命性力量

dappweb

区块链 ao

5个步骤构建优质Redis模块_文化 & 方法_翻译自redis.io_InfoQ精选文章