1. 简介

高效存储和检索数据是软件开发的核心挑战。开发者需要依赖快速、可靠且开销极小的工具来管理数据。

DiceDB 是一个开源、高性能的内存数据库。它提供闪电般的性能和开发者友好的体验,同时支持实时应用。DiceDB 使用熟悉的 SETGET 命令,支持响应式查询等现代特性,最重要的是完全开源。

2. 安装与使用指南

要使用 DiceDB,需要运行 DiceDB 服务器和 DiceDB CLI。

2.1. 运行 DiceDB 实例

可通过 Docker 安装 DiceDB,或从源码构建。本教程使用 Docker 快速启动:

$ docker run -d -p 7379:7379 --name dicedb-container dicedb/dicedb:latest

此命令在后台启动 DiceDB 服务器,容器命名为 dicedb-container。服务运行在本地 7379 端口。

2.2. DiceDB CLI

DiceDB CLI 是官方命令行工具,推荐用于连接服务器。安装命令如下:

$ curl -sL https://raw.githubusercontent.com/dicedb/dicedb-cli/refs/heads/master/install.sh | sh

成功安装后终端会显示:

DiceDB CLI installation complete ✓

启动 CLI 连接数据库:

$ dicedb-cli
localhost:7379>

输出表明已连接到本地 7379 端口的默认 DiceDB 实例。

3. DiceDB 基础操作示例

通过简单示例验证 DiceDB 是否正常运行,并学习基本交互。使用 SET 存储键值对,再用 GET 检索。

定义键值对(键 key1,值 value1):

localhost:7379> SET key1 value1

DiceDB 返回 OK,表示成功存储 key1value1

检索 key1 的值:

localhost:7379> GET key1

返回 OK "value1",即存储的值。

查询不存在的键 key2

localhost:7379> GET key2

返回空字符串 OK "",表示键不存在。

4. 实用 DiceDB 命令集

4.1. DEL – 删除键

删除指定键并返回成功删除的数量。不存在的键会被忽略。

示例:删除 key1key2 和不存在的 key3

localhost:7379> SET key1 value1
OK
localhost:7379> SET key2 value2
OK
localhost:7379> DEL key1 key2 key3
OK 2

返回 OK 2,表示删除了两个存在的键,忽略 key3

4.2. ECHO – 回显输入

返回输入的字符串,常用于测试连接。

localhost:7379> ECHO "Hello from Baeldung!"
OK Hello from Baeldung!

4.3. PING – 检查服务状态

验证服务器是否存活且响应。

localhost:7379> PING
OK "PONG"

返回 PONG 表示 DiceDB 正常运行。

4.4. TYPE – 识别键值类型

返回指定键存储的数据类型(stringint),操作前可做类型校验。

示例:设置不同类型键并检查:

localhost:7379> SET key1 12
OK
localhost:7379> SET key2 Hello
OK
localhost:7379> TYPE key1
OK int
localhost:7379> TYPE key2
OK string

key1 是整数 12key2 是字符串 "Hello"

4.5. EXISTS – 检查键是否存在

返回 1 表示键存在,0 表示不存在。

示例:数据库中只有 key1

localhost:7379> SET key1 value1
OK
localhost:7379> EXISTS key1
OK 1
localhost:7379> EXISTS key22
OK 0

查询 key1 返回 1(存在),key22 返回 0(不存在)。

5. 总结

本文展示了如何连接 DiceDB 实例、存储基础字符串并成功检索。

DiceDB 提供了快速、开源的实时数据处理方案,兼容传统命令并支持现代特性。 官方文档包含更多示例,如聊天室排行榜实现。