使用后端状态存储

• 1: Azure Cosmos DB
• 2: Redis
• 3: SQL Server

1 - Azure Cosmos DB

Dapr 在保存和检索状态时不会转换状态值。Dapr 要求所有状态存储实现遵守特定的键格式方案（参见[状态管理规范](https://docs.dapr.io/zh-hans/reference/api/state_api/）。您可以直接与底层存储交互来操作状态数据，例如：

• 查询状态。
• 创建聚合视图。
• 制作备份。

连接到 Azure Cosmos DB

要连接到您的 Cosmos DB 实例，您可以：

• 使用 Azure 管理门户上的数据资源管理器。
• 使用各种 SDK 和工具。

按 App ID 列出键

要获取与应用程序 “myapp” 关联的所有状态键，请使用以下查询：

SELECT * FROM states WHERE CONTAINS(states.id, 'myapp||')

上述查询返回 id 包含 “myapp-” 的所有文档，这是状态键的前缀。

获取特定状态数据

要获取应用程序 “myapp” 中键为 “balance” 的状态数据，请使用以下查询：

SELECT * FROM states WHERE states.id = 'myapp||balance'

读取返回文档中的 value 字段。要获取状态版本/ETag，请使用以下命令：

SELECT states._etag FROM states WHERE states.id = 'myapp||balance'

读取 Actor 状态

要获取应用程序 ID 为 “mypets” 中 Actor 类型为 “cat” 且实例 ID 为 “leroy” 的 Actor 关联的所有状态键，请使用以下命令：

SELECT * FROM states WHERE CONTAINS(states.id, 'mypets||cat||leroy||')

而要获取特定的 Actor 状态（如 “food”），请使用以下命令：

SELECT * FROM states WHERE states.id = 'mypets||cat||leroy||food'

2 - Redis

Dapr 在保存和检索状态时不会转换状态值。Dapr 要求所有状态存储实现都遵循一定的键格式方案（参见状态管理规范）。您可以直接与底层存储交互来操作状态数据，例如：

• 查询状态。
• 创建聚合视图。
• 进行备份。

Dapr 提供了一个 Redis state store component 作为可插拔组件。

连接到 Redis

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

docker run --rm -it --link <Redis 容器的名称> redis redis-cli -h <Redis 容器的名称>

按应用 ID 列出键

要获取与应用 “myapp” 关联的所有状态键，请使用命令：

KEYS myapp*

上述命令返回现有键的列表，例如：

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

获取特定状态数据

Dapr 将状态值保存为哈希值。每个哈希值包含一个 “data” 字段，其中包含：

• 状态数据。
• 一个 “version” 字段，其中包含一个持续递增的版本，用作 ETag。

例如，要获取应用 “myapp” 的键 “balance” 对应的状态数据，请使用命令：

HGET myapp||balance data

要获取状态版本/ETag，请使用命令：

HGET myapp||balance version

读取 Actor 状态

要获取与应用 ID “mypets” 中 actor 类型为 “cat” 且实例 ID 为 “leroy” 的 actor 关联的所有状态键，请使用命令：

KEYS mypets||cat||leroy*

要获取特定的 actor 状态（如 “food”），请使用命令：

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

3 - SQL Server

Dapr 在保存和检索状态时不会转换状态值。Dapr 要求所有状态存储实现都遵守一定的键格式方案（请参阅状态管理规范）。你可以直接与底层存储交互来操作状态数据，例如：

• 查询状态。
• 创建聚合视图。
• 进行备份。

连接到 SQL Server

连接 SQL Server 实例最简单的方式是使用：

• Azure Data Studio（Windows、macOS、Linux）
• SQL Server Management Studio（Windows）

按 App ID 列出键

要获取与应用程序 “myapp” 关联的所有状态键，请使用以下查询：

SELECT * FROM states WHERE [Key] LIKE 'myapp||%'

上述查询返回所有 ID 包含 “myapp||” 的行，这是状态键的前缀。

获取特定状态数据

要获取应用程序 “myapp” 中键为 “balance” 的状态数据，请使用以下查询：

SELECT * FROM states WHERE [Key] = 'myapp||balance'

读取返回行的 Data 字段。要获取状态版本/ETag，请使用以下命令：

SELECT [RowVersion] FROM states WHERE [Key] = 'myapp||balance'

获取过滤后的状态数据

要获取 JSON 数据中 “color” 值等于 “blue” 的所有状态数据，请使用以下查询：

SELECT * FROM states WHERE JSON_VALUE([Data], '$.color') = 'blue'

读取 Actor 状态

要获取属于应用程序 ID 为 “mypets”、Actor 类型为 “cat”、实例 ID 为 “leroy” 的所有 Actor 状态键，请使用以下命令：

SELECT * FROM states WHERE [Key] LIKE 'mypets||cat||leroy||%'

要获取特定的 Actor 状态（如 “food”），请使用以下命令：

SELECT * FROM states WHERE [Key] = 'mypets||cat||leroy||food'