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

Azure Cosmos DB

使用 azure Cosmos DB 作为状态存储

Dapr 在保存和检索状态时不会转换状态值。 Dapr要求所有的状态存储实现都要遵守特定的密钥格式方案(请参见状态管理规范)。 您可以直接与底层存储交互,以操纵状态数据,例如:

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

连接到 Azure Cosmos DB

要连接到您的 Cosmos DB 实例,您可以选择以下任一方式:

通过 App ID 列出键

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

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

上面的查询返回所有id,也就是状态键前缀为 “myapp-” 的记录。

获取特定状态数据

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

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

读取返回的文档的 value 字段。 要获取状态 version/ETag ,请使用以下命令:

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

读取Actor 状态

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

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

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

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