LedisDB 命令详解：从基础操作到高级功能
项目地址: https://gitcode.com/gh_mirrors/le/ledisdb 概述
LedisDB 是一个基于 Go 语言开发的高性能 NoSQL 数据库服务器，采用 Redis 协议（RESP）进行通信，支持多种数据结构包括 KV（键值对）、List（列表）、Hash（哈希）、Set（集合）和 ZSet（有序集合）。与 Redis 不同，LedisDB 将数据持久化存储在磁盘上，不受内存限制。
本文将深入解析 LedisDB 的命令系统，从基础操作到高级功能，帮助开发者全面掌握 LedisDB 的使用技巧。
基础数据结构命令
KV（键值对）操作
KV 是 LedisDB 中最基础的数据结构，用于存储简单的键值对数据。
SET/GET 基础操作
// 设置键值对
SET key value
// 获取键值
GET key
// 示例
ledis> SET username "john_doe"
OK
ledis> GET username
"john_doe"
批量操作命令
// 批量设置多个键值对
MSET key1 value1 key2 value2 ...
// 批量获取多个键的值
MGET key1 key2 ...
// 示例
ledis> MSET name "John" age "30" city "New York"
OK
ledis> MGET name age city
1) "John"
2) "30"
3) "New York"
数值操作命令
// 自增操作
INCR key
INCRBY key increment
// 自减操作
DECR key
DECRBY key decrement
// 示例
ledis> SET counter 100
OK
ledis> INCR counter
(integer) 101
ledis> INCRBY counter 50
(integer) 151
ledis> DECR counter
(integer) 150
Hash（哈希）操作
Hash 用于存储字段-值映射表，适合存储对象数据。
基础 Hash 操作
// 设置哈希字段
HSET key field value
// 获取哈希字段
HGET key field
// 获取所有字段和值
HGETALL key
// 示例
ledis> HSET user:1000 name "Alice" age "25" email "alice@example.com"
(integer) 3
ledis> HGET user:1000 name
"Alice"
ledis> HGETALL user:1000
1) "name"
2) "Alice"
3) "age"
4) "25"
5) "email"
6) "alice@example.com"
批量 Hash 操作
// 批量设置多个字段
HMSET key field1 value1 field2 value2 ...
// 批量获取多个字段
HMGET key field1 field2 ...
// 示例
ledis> HMSET product:1001 name "Laptop" price "999" category "Electronics"
OK
ledis> HMGET product:1001 name price
1) "Laptop"
2) "999"
List（列表）操作
List 是简单的字符串列表，按照插入顺序排序，支持从两端操作。
列表基础操作
// 从左侧推入元素
LPUSH key value [value ...]
// 从右侧推入元素
RPUSH key value [value ...]
// 从左侧弹出元素
LPOP key
// 从右侧弹出元素
RPOP key
// 获取列表范围
LRANGE key start stop
// 示例
ledis> LPUSH tasks "task1" "task2" "task3"
(integer) 3
ledis> LRANGE tasks 0 -1
1) "task3"
2) "task2"
3) "task1"
ledis> RPOP tasks
"task1"
Set（集合）操作
Set 是 String 类型的无序集合，通过哈希表实现，不允许重复成员。
集合基础操作
// 添加成员到集合
SADD key member [member ...]
// 获取集合所有成员
SMEMBERS key
// 判断成员是否存在
SISMEMBER key member
// 移除集合成员
SREM key member [member ...]
// 示例
ledis> SADD tags "python" "go" "java" "python"
(integer) 3
ledis> SMEMBERS tags
1) "go"
2) "java"
3) "python"
ledis> SISMEMBER tags "go"
(integer) 1
ZSet（有序集合）操作
ZSet 与 Set 类似，但每个成员都关联一个分数（score），用于排序。
有序集合操作
// 添加成员和分数
ZADD key score member [score member ...]
// 按分数范围获取成员
ZRANGEBYSCORE key min max [WITHSCORES]
// 按排名获取成员
ZRANGE key start stop [WITHSCORES]
// 示例
ledis> ZADD leaderboard 1000 "player1" 2000 "player2" 1500 "player3"
(integer) 3
ledis> ZRANGE leaderboard 0 -1 WITHSCORES
1) "player1"
2) "1000"
3) "player3"
4) "1500"
5) "player2"
6) "2000"
高级功能命令
键过期管理
LedisDB 支持为键设置过期时间，自动删除过期数据。
// 设置键过期时间（秒）
EXPIRE key seconds
// 设置键过期时间戳
EXPIREAT key timestamp
// 获取键剩余生存时间
TTL key
// 移除键的过期时间
PERSIST key
// 示例
ledis> SET session:abc123 "user_data"
OK
ledis> EXPIRE session:abc123 3600 // 1小时后过期
(integer) 1
ledis> TTL session:abc123
(integer) 3598
数据持久化操作
// 序列化键值
DUMP key
// 反序列化数据
RESTORE key ttl value
// 示例
ledis> SET mykey "important data"
OK
ledis> DUMP mykey
"\x00\x0cimportant data\x06\x00\xf8r?\xc5\xfb\xfb_("
扫描和迭代操作
LedisDB 提供扫描命令用于安全地迭代大量数据。
// 通用扫描命令
XSCAN type cursor [MATCH pattern] [COUNT count] [ASC|DESC]
// 哈希扫描
XHSCAN key cursor [MATCH pattern] [COUNT count]
// 示例：迭代所有KV键
ledis> XSCAN kv 0 MATCH user:* COUNT 10
1) "15" // 下一个游标
2) 1) "user:1000"
2) "user:1001"
3) "user:1002"
Lua 脚本支持
LedisDB 支持使用 Lua 脚本执行复杂操作。
// 执行Lua脚本
EVAL script numkeys key [key ...] arg [arg ...]
// 示例：原子性计数器
ledis> EVAL "local current = redis.call('GET', KEYS[1]); current = tonumber(current) or 0; redis.call('SET', KEYS[1], current + ARGV[1]); return current + ARGV[1]" 1 counter 5
(integer) 5
数据管理命令
数据库操作
// 选择数据库（0-15）
SELECT index
// 清空当前数据库
FLUSHDB
// 清空所有数据库
FLUSHALL
// 获取服务器信息
INFO [section]
// 示例
ledis> SELECT 1
OK
ledis> SET db1_key "value"
OK
ledis> SELECT 0
OK
ledis> FLUSHDB
OK
复制功能
LedisDB 支持主从复制，确保数据安全。
// 设置从节点
SLAVEOF host port [RESTART] [READONLY]
// 强制全量同步
FULLSYNC [NEW]
// 增量同步
SYNC logid
// 示例
ledis> SLAVEOF 192.168.1.100 6380
OK
性能优化技巧
批量操作提升性能
// 使用管道(pipeline)批量执行命令
// 客户端示例代码（Go语言）
package main
import (
"github.com/ledisdb/ledisdb/ledis"
)
func main() {
cfg := ledis.NewConfigDefault()
l, _ := ledis.Open(cfg)
db, _ := l.Select(0)
// 批量设置
batch := db.NewBatch()
for i := 0; i < 1000; i++ {
batch.Set([]byte(fmt.Sprintf("key%d", i)), []byte(fmt.Sprintf("value%d", i)))
}
batch.Commit()
}
合理使用数据结构
错误处理与调试
常见错误代码
| 错误类型 | 描述 | 解决方法 |
|---|---|---|
| ERR wrong number of arguments | 参数数量错误 | 检查命令参数数量 |
| ERR value is not an integer | 值不是整数 | 确保操作数值为整数 |
| ERR no such key | 键不存在 | 检查键是否存在 |
| ERR syntax error | 语法错误 | 检查命令格式 |
调试技巧
// 使用MONITOR命令实时监控命令执行
ledis> MONITOR
OK
// 所有执行命令将实时显示
// 使用SLOWLOG查看慢查询
ledis> SLOWLOG GET 10
1) 1) (integer) 1
2) (integer) 1633043257
3) (integer) 150
4) 1) "GET"
2) "user:1000:profile"
最佳实践
1. 键命名规范
// 使用冒号分隔的层次结构
SET user:1000:profile "{...json data...}"
SET order:2023:1000:items "[...]"
SET cache:article:1000:comments "..."
// 避免过长的键名
// 错误示例
SET this_is_a_very_long_key_name_that_is_hard_to_read_and_remember "value"
// 正确示例
SET user:1000:name "John"
2. 内存优化策略
// 使用Hash存储对象而非多个KV
// 不推荐
SET user:1000:name "John"
SET user:1000:age "30"
SET user:1000:email "john@example.com"
// 推荐
HMSET user:1000 name "John" age "30" email "john@example.com"
// 使用适当的数据过期策略
EXPIRE session:abc123 3600 // 1小时
EXPIRE cache:article:1000 300 // 5分钟
3. 事务处理
// 使用MULTI/EXEC实现事务
ledis> MULTI
OK
ledis> SET balance:1000 1000
QUEUED
ledis> DECRBY balance:1000 100
QUEUED
ledis> INCRBY balance:2000 100
QUEUED
ledis> EXEC
1) OK
2) (integer) 900
3) (integer) 100
总结
LedisDB 提供了丰富而强大的命令集，从基础的数据操作到高级的功能特性，能够满足各种应用场景的需求。通过本文的详细解析，开发者可以：
- 掌握核心数据结构：KV、Hash、List、Set、ZSet 的全面操作
- 运用高级功能：键过期、Lua脚本、数据扫描、复制等
- 优化性能：批量操作、管道技术、合理数据结构选择
- 遵循最佳实践：规范的键命名、内存优化、事务处理
LedisDB 作为 Redis 协议的兼容实现，既保持了 Redis 的易用性，又提供了磁盘持久化的优势，是构建高性能、高可靠性应用的优秀选择。
通过系统学习和实践这些命令，您将能够充分发挥 LedisDB 的潜力，构建出高效、稳定的数据存储解决方案。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
