StackExchange.Redis文档翻译

• 语言: 中文（简体）
• 格式: .pdf
• 来源: github.com/ningyu1

摘要

该文档是对StackExchange.Redis库的翻译介绍，该库是Stack Overflow提供的免费Redis客户端库，用于替代收费的ServiceStack.Redis。文档涵盖了基本用法、配置、管道和多路复用器、键值及通道、事务、事件、发布/订阅消息顺序、KEYS/SCAN/FLUSHDB等命令、性能分析和脚本等主题。文档强调键是数据的唯一标识，影响命令传送；值则存储数据但不影响传送。事务部分说明Redis事务与SQL不同，提供MULTI、EXEC、DISCARD等命令，保证隔离性和原子性。配置支持自动和手动方式，可排除或重命名命令。性能分析通过IProfiler接口实现，记录命令的计时信息。事件包括配置更改、连接失败/恢复、错误消息等。

AI总结

StackExchange.Redis 是一个由 Stack Overflow 提供的免费、开源的 Redis 客户端库，适用于 .NET 平台。该文档是其中文翻译，旨在帮助开发者理解和使用该库。

**背景与动机**：由于 ServiceStack.Redis 从 4.0 版本开始收费，因此 StackExchange.Redis 作为免费替代品被广泛采用。文档翻译者出于学习和共享精神进行了翻译，并欢迎读者提交 PR 以修正错误。

**文档核心内容**：文档涵盖了 StackExchange.Redis 的主要功能模块，包括：
- **基本用法**：如何使用该库连接和操作 Redis。
- **配置**：支持自动和手动配置，可通过字符串或 `ConfigurationOptions` 对象设置。关键配置项包括：服务器端点、密码、SSL、超时、版本、命令映射等。对于禁用或重命名命令的场景，可通过 `CommandMap` 实现。
- **管道和多路复用器**：利用多路复用特性高效处理请求。
- **键、值和通道**：API 明确区分 `RedisKey` 和 `RedisValue` 类型，以匹配 Redis 的数据模型。键和值可隐式从 `string` 和 `byte[]` 转换。通道用于发布/订阅模式。
- **事务**：Redis 事务与 SQL 不同，通过 `MULTI`、`EXEC`、`DISCARD`、`WATCH` 等命令实现原子性和隔离性。在 StackExchange.Redis 中，可通过内置的 `When` 条件和 Lua 脚本实现事务逻辑。
- **事件**：`ConnectionMultiplexer` 提供多个事件（如 `ConfigurationChanged`、`ConnectionFailed`、`ConnectionRestored`、`ErrorMessage` 等），便于监控和日志记录。
- **发布/订阅**：支持消息的顺序处理。
- **KEYS、SCAN、FLUSHDB 等命令**：文档解释了这些命令的使用位置。
- **性能分析**：通过 `IProfiler` 接口和 `BeginProfiling`/`FinishProfiling` 方法，可以收集命令的计时信息（如排队时间、发送时间、响应时间等），用于性能监控和调试。
- **脚本**：支持 Lua 脚本执行，`ScriptEvaluate` 和 `ScriptEvaluateAsync` 方法的返回值类型取决于脚本内容，可强制转换为 `bool` 等类型。

**总结**：该文档系统介绍了 StackExchange.Redis 的核心功能、配置方法、事务处理、事件机制和性能分析工具，为 .NET 开发者使用 Redis 提供了实用的参考。