与后端状态存储交互 on Dapr 文档库

Azure Cosmos DB

Mon, 01 Jan 0001 00:00:00 +0000

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

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

注意

Azure Cosmos DB 是一个支持多种 API 的多模式数据库。默认的 Dapr Cosmos DB 状态存储实现使用 Azure Cosmos DB SQL API。

连接到 Azure Cosmos DB

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

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

注意

当您为 Dapr 配置 Azure Cosmos DB 时，请指定要使用的具体数据库和集合。以下 Cosmos DB SQL API 示例假设您已连接到正确的数据库和名为 “states” 的集合。

按应用程序 ID 列出键

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

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

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

获取特定状态数据

要通过键 “balance” 获取应用程序 “myapp” 的状态数据，请使用查询：

Redis

Mon, 01 Jan 0001 00:00:00 +0000

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

注意

以下示例使用 Redis CLI 针对使用默认 Dapr 状态存储实现的 Redis 存储。

连接到 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，表示不断递增的版本。

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

HGET myapp||balance data

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

HGET myapp||balance version

读取 actor 状态

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

SQL server

Mon, 01 Jan 0001 00:00:00 +0000

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

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

连接到 SQL Server

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

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

注意

当您为 Dapr 配置 Azure SQL 数据库时，您需要指定具体的表名。以下 Azure SQL 示例假设您已经连接到具有名为 “states” 的表的正确数据库。

按应用程序 ID 列出键

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

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

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

获取特定状态数据

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

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

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

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

获取过滤的状态数据

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