文档：快速入门指南

本快速入门指南将向您展示如何

1. 开始使用 Valkey
2. 在 Valkey 中将数据存储到键下
3. 从 Valkey 中通过键检索数据
4. 扫描键空间以查找与特定模式匹配的键

本文中的示例引用了一个简单的自行车库存。

设置

请参阅安装指南，以在本地机器上安装 Valkey。

连接

第一步是连接到 Valkey。有适用于大多数编程语言的客户端连接器。您还可以使用命令行界面valkey-cli进行连接。以下示例展示了如何连接到在本地主机 (-h 127.0.0.1) 上运行并侦听默认端口 (-p 6379) 的 Valkey 服务器。

$ valkey-cli -h 127.0.0.1 -p 6379

存储和检索数据

Valkey 是一个远程字典服务器。您可以使用与本地编程环境相同的数据类型，但这些数据类型在 Valkey 的服务器端。

与字节数组类似，字符串存储字节序列，包括文本、序列化对象、计数器值和二进制数组。以下示例展示了如何设置和获取字符串值

127.0.0.1:6379> SET bike:1 "Process 134"
OK
127.0.0.1:6379> GET bike:1
"Process 134"

哈希等同于字典（dict 或哈希映射）。此外，您可以使用哈希来表示普通对象并存储计数器组。以下示例解释了如何设置和访问对象的字段值

127.0.0.1:6379> HSET bike:1 model Deimos brand Ergonom type 'Enduro bikes' price 4972
(integer) 4
127.0.0.1:6379> HGET bike:1 model
"Deimos"
127.0.0.1:6379> HGET bike:1 price
"4972"
127.0.0.1:6379> HGETALL bike:1
1) "model"
2) "Deimos"
3) "brand"
4) "Ergonom"
5) "type"
6) "Enduro bikes"
7) "price"
8) "4972"

您可以在本文档网站的数据类型部分获取可用数据类型的完整概述。每种数据类型都有允许您操作或检索数据的命令。命令参考提供了详细的解释。

扫描键空间

Valkey 中的每个项都有一个唯一的键。所有项都存在于 Valkey 键空间中。您可以通过 SCAN 命令扫描 Valkey 键空间。以下是一个扫描前 100 个带有前缀 bike: 的键的示例：

127.0.0.1:6379> SCAN 0 MATCH "bike:*" COUNT 100
1) "0"
2) 1) "bike:4"
   2) "bike:3"
   3) "bike:5"
   4) "bike:1"
   5) "bike:2"

SCAN 返回一个游标位置，允许您迭代扫描下一批键，直到游标值达到 0。