The documentation you are viewing is for Dapr v1.12 which is an older version of Dapr. For up-to-date documentation, see the latest version.

Redis

使用 Redis 作为后端状态存储

Dapr 在保存和检索状态时不会转换状态值。 Dapr 要求所有的状态存储实现都要遵守特定的密钥格式 (参见 Dapr 状态管理规范)。 您可以直接与基础存储进行交互以操作状态数据,例如查询状态、创建聚合视图和进行备份。

注: 以下示例使用 Redis CLI 来查询作为Dapr默认状态存储实现的 Redis 中的状态数据。

1. 连接Redis

您可以使用官方 redis-cli 或任何其他 Redis 兼容工具连接到 Redis 状态存储以直接查询 Dapr 状态。 如果您正在容器中运行 Redis ,那么使用 redis-cli 的最简单方法是使用容器:

docker run --rm -it --link <name of the Redis container> redis redis-cli -h <name of the Redis container>

2. 通过 App ID 列出键

要获取与应用程序 “myapp” 关联的所有状态,请使用命令:

KEYS myapp*

上述命令返回现有键的列表,例如:

1) "myapp||balance"
2) "myapp||amount"

3. 获取特定状态数据

Dapr 将状态值保存为哈希值。 每个散列值包含一个 “data” 字段,其中包含状态数据和 “version” 字段,该字段包含作为 ETag 的不断递增的版本。

例如,要获取应用程序 “myapp” 的键 “balance” 的状态数据,请使用以下命令:

HGET myapp||balance data

要获取状态 version/ETag ,请使用以下命令:

HGET myapp||balance version

4. 获取 actor 状态

要获取应用ID为 “myets “,实例ID为 “leroy”,actor 类型为 “cat” 的相关联所有 actor 的状态键,请使用以下命令:

KEYS mypets||cat||leroy*

要获取特定 actor 状态(如"food”) ,请使用以下命令:

HGET mypets||cat||leroy||food value

警告: 您不应该手动更新或删除存储引擎中的状态。 所有的写入和删除操作都应该通过 Dapr 运行时来完成。