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.

SQL server

使用 SQL Server 作为后端状态存储

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

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

连接到 SQL Server

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

通过 App ID 列出键

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

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

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

获取特定状态数据

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

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

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

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

获取过滤后的状态数据

执行下面的查询，以获取 json 数据中 “color” 值等于 “blue” 的所有状态数据：

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

读取Actor 状态

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

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

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

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