流数据结构与命令
学习添加条目(`XADD`)、读取流(`XREAD`)以及管理流长度
流数据结构与命令 是 CoddyKit 上的免费 Redis Caching & Messaging (Pub/Sub, Streams) 课时。 这是第 2 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Redis Caching & Messaging (Pub/Sub, Streams) 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Redis Caching & Messaging (Pub/Sub, Streams) 课程共包含 4 节课。
本课时的部分内容尚未翻译,以英文显示。
Welcome to Stream Data
In the previous lesson, we learned what Redis Streams are. Now, let's dive into their core structure and how we interact with them.
Redis Streams are powerful, append-only data structures that act like a log, storing a sequence of entries. Each entry has a unique ID and a set of field-value pairs.
Stream Entry Anatomy
Each entry in a Redis Stream is like a small record. It consists of:
- Entry ID: A unique identifier, typically a timestamp and a sequence number (e.g.,
1678886400000-0). - Field-Value Pairs: One or more key-value pairs representing the actual data of the entry (e.g.,
sensor-id: 123,temperature: 25.5).
Think of it like a mini-hash map stored chronologically within the stream.
Adding Entries with XADD
To add a new entry to a Redis Stream, we use the XADD command. This command appends a new entry to the end of the stream, generating a unique ID.
The basic syntax is:
XADD key ID field value [field value ...]For the ID argument, you'll typically use * to let Redis automatically assign a unique ID based on the current time.
XADD Command Example
Let's add some sensor data to a stream named sensor_readings. We'll use * to let Redis automatically assign a unique ID.
XADD sensor_readings * sensor-id 101 temperature 23.5 humidity 60
XADD sensor_readings * sensor-id 102 temperature 24.1 humidity 62Reading from Streams: XREAD
Once data is in a stream, you'll want to read it. The XREAD command is used for this purpose. It allows you to read entries from one or more streams, starting from a specific ID.
A common way to read from the very beginning of a stream is to use 0-0 as the starting ID for that stream.
Basic XREAD Operations
Let's read the entries we just added. We can specify COUNT to limit the number of entries returned. The $ ID means 'read only new entries added since the last time I read' or 'from now' if it's the first read. It's great for tailing a stream!
XREAD COUNT 2 STREAMS sensor_readings 0-0
XREAD STREAMS sensor_readings $Managing Stream Length: MAXLEN
Streams can grow infinitely, consuming a lot of memory. To prevent this, Redis allows you to limit the maximum length of a stream using the MAXLEN option with XADD.
When the stream exceeds the specified length, older entries are automatically evicted from the head of the stream.
XADD with MAXLEN Example
We can add entries and ensure our sensor_readings stream never exceeds a certain number of entries. Using ~ before the count makes the trimming approximate, which is faster and often sufficient.
XADD sensor_readings MAXLEN ~ 3 * sensor-id 103 temperature 24.8 humidity 61
XADD sensor_readings MAXLEN ~ 3 * sensor-id 104 temperature 25.2 humidity 63
XADD sensor_readings MAXLEN ~ 3 * sensor-id 105 temperature 25.0 humidity 60
XLEN sensor_readingsQuick Check: Stream Commands
You've learned about adding and reading stream entries, as well as managing stream length. Let's test your understanding.
Recap: Stream Basics
Great job! In this lesson, you mastered the fundamental commands for interacting with Redis Streams:
XADD: To append new entries with unique IDs and field-value pairs.XREAD: To retrieve entries from streams, starting from a specific ID or reading new entries with$.MAXLEN: To control stream size duringXADDoperations, preventing unbounded memory growth.
Next, we'll explore how Streams provide message persistence and ordered delivery, differentiating them from Pub/Sub.
常见问题解答
「流数据结构与命令」课时是免费的吗?
是的 — 「流数据结构与命令」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Redis Caching & Messaging (Pub/Sub, Streams) 课程的其余内容,请升级到 CoddyKit PRO。 Redis Caching & Messaging (Pub/Sub, Streams) 课程共包含 4 节课。
「流数据结构与命令」这节课中我会学到什么?
学习添加条目(`XADD`)、读取流(`XREAD`)以及管理流长度 你通过在浏览器中直接运行的动手代码来练习 Redis Caching & Messaging (Pub/Sub, Streams),全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Redis Caching & Messaging (Pub/Sub, Streams) 需要有经验吗?
无需任何先前经验。CoddyKit 上的 Redis Caching & Messaging (Pub/Sub, Streams) 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 2 节课,共 4 节。
「流数据结构与命令」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 Redis Caching & Messaging (Pub/Sub, Streams) 课中编写并运行代码吗?
能。每节 Redis Caching & Messaging (Pub/Sub, Streams) 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。
此课程中的所有课时
- 什么是 Redis Streams?
- 流数据结构与命令
- 流消息持久化
- 限制与裁剪流