状态存储组件说明 on Dapr 文档库

Aerospike

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

组件格式

要配置 Aerospike 状态存储，请创建一个类型为 state.Aerospike 的组件。请参阅本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.Aerospike
 version: v1
 metadata:
 - name: hosts
 value: <REPLACE-WITH-HOSTS> # 必需。以逗号分隔的主机字符串。例如："aerospike:3000,aerospike2:3000"
 - name: namespace
 value: <REPLACE-WITH-NAMESPACE> # 必需。Aerospike 命名空间。
 - name: set
 value: <REPLACE-WITH-SET> # 可选

警告

上述示例使用未加密的字符串作为 secret。建议使用 secret 存储来保护 secret，如此处所述。

配置元数据字段

字段	必需	详情	示例
hosts	Y	数据库服务器的主机名/端口	`"localhost:3000"`, `"aerospike:3000,aerospike2:3000"`
namespace	Y	Aerospike 命名空间	`"namespace"`
set	N	数据库中的 setName	`"myset"`

设置 Aerospike

您可以使用 Docker 在本地运行 Aerospike：

AWS DynamoDB

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

组件格式

要设置 DynamoDB 状态存储，需要创建一个类型为 state.aws.dynamodb 的组件。请参考本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.aws.dynamodb
 version: v1
 metadata:
 - name: table
 value: "Contracts"
 - name: accessKey
 value: "AKIAIOSFODNN7EXAMPLE" # 可选
 - name: secretKey
 value: "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" # 可选
 - name: endpoint
 value: "http://localhost:8080" # 可选
 - name: region
 value: "eu-west-1" # 可选
 - name: sessionToken
 value: "myTOKEN" # 可选
 - name: ttlAttributeName
 value: "expiresAt" # 可选
 - name: partitionKey
 value: "ContractID" # 可选
 # 如果希望将 AWS DynamoDB 用作 actor 的状态存储，请取消注释此行（可选）
 #- name: actorStateStore
 # value: "true"

警告

上述示例使用明文字符串作为 secret。建议使用 secret 存储来存储 secret，如此处所述。

主键

要将 DynamoDB 用作 Dapr 状态存储，表必须有一个名为 key 的主键。请参考分区键部分以了解如何更改此设置。

Azure Blob 存储

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

组件格式

要设置 Azure Blob 存储状态存储，请创建一个类型为 state.azure.blobstorage 的组件。请参阅本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.azure.blobstorage
 # 支持 v1 和 v2。用户应始终默认使用 v2。没有从 v1 到 v2 的迁移路径，请参见下文的 `versioning`。
 version: v2
 metadata:
 - name: accountName
 value: "[your_account_name]"
 - name: accountKey
 value: "[your_account_key]"
 - name: containerName
 value: "[your_container_name]"

警告

上述示例中，secret 使用了明文字符串。建议使用 secret 存储来存储 secret，如此处所述。

版本控制

Dapr 提供了两个版本的 Azure Blob 存储状态存储组件：v1 和 v2。建议所有新应用程序使用 v2。v1 被视为遗留版本，仅为与现有应用程序的兼容性而保留。

Azure Cosmos DB（SQL API）

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

组件格式

要设置 Azure Cosmos DB 状态存储，请创建一个类型为 state.azure.cosmosdb 的组件。请参阅本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.azure.cosmosdb
 version: v1
 metadata:
 - name: url
 value: <REPLACE-WITH-URL>
 - name: masterKey
 value: <REPLACE-WITH-MASTER-KEY>
 - name: database
 value: <REPLACE-WITH-DATABASE>
 - name: collection
 value: <REPLACE-WITH-COLLECTION>
 # 如果希望将 Azure Cosmos DB 用作 actor 的状态存储，请取消注释此行（可选）
 #- name: actorStateStore
 # value: "true"

警告

上述示例中使用了明文字符串来存储密钥。建议使用密钥存储来保护这些信息，具体方法请参阅此处。

如果希望将 Cosmos DB 用作 actor 存储，请在 yaml 中添加以下内容。

Azure 表存储

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

组件格式

要配置 Azure 表存储状态组件，请创建一个类型为 state.azure.tablestorage 的组件。请参阅本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.azure.tablestorage
 version: v1
 metadata:
 - name: accountName
 value: <REPLACE-WITH-ACCOUNT-NAME>
 - name: accountKey
 value: <REPLACE-WITH-ACCOUNT-KEY>
 - name: tableName
 value: <REPLACE-WITH-TABLE-NAME>
# - name: cosmosDbMode
# value: false

警告

上述示例中，secret 以明文字符串形式使用。建议使用 secret 存储来保护 secret，详情请参阅此处。

元数据字段说明

字段	必需	详情	示例
`accountName`	是	存储帐户名称	`"mystorageaccount"`
`accountKey`	是	主存储或辅助存储密钥	`"key"`
`tableName`	是	用于 Dapr 状态的表名。如果不存在，将自动创建	`"table"`
`cosmosDbMode`	否	启用后，将连接到 Cosmos DB 表 API 而非 Azure 表。默认为 `false`	`"false"`
`serviceURL`	否	完整的存储服务端点 URL，适用于非公共云的 Azure 环境	`"https://mystorageaccount.table.core.windows.net/"`
`skipCreateTable`	否	跳过检查并在必要时创建指定的存储表，适用于最低权限的活动目录身份验证。默认为 `false`	`"true"`

Microsoft Entra ID 认证

Azure Cosmos DB 状态组件支持所有 Microsoft Entra ID 认证机制。有关更多信息以及如何选择适合的组件元数据字段，请参阅Azure 认证文档。

Cassandra

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

组件格式

要配置 Cassandra 状态存储组件，请创建一个类型为 state.cassandra 的组件。请参阅本指南以了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.cassandra
 version: v1
 metadata:
 - name: hosts
 value: <用逗号分隔的主机列表> # 必需。示例：cassandra.cassandra.svc.cluster.local
 - name: username
 value: <用户名> # 可选。默认值：""
 - name: password
 value: <密码> # 可选。默认值：""
 - name: consistency
 value: <一致性级别> # 可选。默认值："All"
 - name: table
 value: <表名> # 可选。默认值："items"
 - name: keyspace
 value: <键空间> # 可选。默认值："dapr"
 - name: protoVersion
 value: <协议版本> # 可选。默认值："4"
 - name: replicationFactor
 value: <复制因子> # 可选。默认值："1"

警告

上述示例中使用了明文字符串来存储秘密信息。建议使用秘密存储来保护这些信息，详情请参阅此处。

规格元数据字段

字段	必需	说明	示例
hosts	是	用逗号分隔的主机列表	`"cassandra.cassandra.svc.cluster.local"`。
port	否	通信端口。默认值为 `"9042"`	`"9042"`
username	是	数据库用户的用户名。无默认值	`"user"`
password	是	用户的密码	`"password"`
consistency	否	一致性级别	`"All"`，`"Quorum"`
table	否	表名。默认值为 `"items"`	`"items"`，`"tab"`
keyspace	否	要使用的 Cassandra 键空间。默认值为 `"dapr"`	`"dapr"`
protoVersion	否	客户端的协议版本。默认值为 `"4"`	`"3"`，`"4"`
replicationFactor	否	复制因子。默认值为 `"1"`	`"3"`

设置 Cassandra

您可以使用 Datastax 的 Docker 镜像在本地运行 Cassandra：

Cloudflare Workers KV

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

创建 Dapr 组件

要配置 Cloudflare Workers KV 状态存储，您需要创建一个类型为 state.cloudflare.workerskv 的组件。请参考本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.cloudflare.workerskv
 version: v1
 # 如果 Dapr 为您管理 Worker，请增加 initTimeout
 initTimeout: "120s"
 metadata:
 # Workers KV 命名空间的 ID（必需）
 - name: kvNamespaceID
 value: ""
 # Worker 的名称（必需）
 - name: workerName
 value: ""
 # PEM 编码的私有 Ed25519 密钥（必需）
 - name: key
 value: |
 -----BEGIN PRIVATE KEY-----
 MC4CAQ...
 -----END PRIVATE KEY-----
 # Cloudflare 账户 ID（需要 Dapr 管理 Worker 时必需）
 - name: cfAccountID
 value: ""
 # Cloudflare 的 API 令牌（需要 Dapr 管理 Worker 时必需）
 - name: cfAPIToken
 value: ""
 # Worker 的 URL（如果 Worker 已在 Dapr 外部预创建，则必需）
 - name: workerUrl
 value: ""

警告

上述示例使用明文字符串作为 secret。建议使用 secret 存储来存储 secret，如此处所述。

规格元数据字段

字段	必需	详情	示例
`kvNamespaceID`	Y	预创建的 Workers KV 命名空间的 ID	`"123456789abcdef8b5588f3d134f74ac"`
`workerName`	Y	要连接的 Worker 的名称	`"mydaprkv"`
`key`	Y	Ed25519 私钥，PEM 编码	见上面的示例
`cfAccountID`	Y/N	Cloudflare 账户 ID。需要 Dapr 管理 Worker。	`"456789abcdef8b5588f3d134f74ac"def`
`cfAPIToken`	Y/N	Cloudflare 的 API 令牌。需要 Dapr 管理 Worker。	`"secret-key"`
`workerUrl`	Y/N	Worker 的 URL。如果 Worker 已在 Dapr 外部预配置，则必需。	`"https://mydaprkv.mydomain.workers.dev"`

如果您配置 Dapr 为您创建 Worker，可能需要为组件的 initTimeout 属性设置更长的值，以便为 Worker 脚本的部署留出足够的时间。例如：initTimeout: "120s"

CockroachDB

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

创建一个 Dapr 组件

创建一个名为 cockroachdb.yaml 的文件，粘贴以下内容并将 <CONNECTION STRING> 值替换为您的连接字符串。CockroachDB 的连接字符串与 PostgreSQL 的连接字符串标准相同。例如，"host=localhost user=root port=26257 connect_timeout=10 database=dapr_test"。有关如何定义连接字符串的信息，请参阅 CockroachDB 数据库连接文档。

如果您还想配置 CockroachDB 来存储 actor 状态，请添加 actorStateStore 选项，如下面的示例所示。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.cockroachdb
 version: v1
 metadata:
 # 连接字符串
 - name: connectionString
 value: "<CONNECTION STRING>"
 # 数据库操作的超时时间，以秒为单位（可选）
 #- name: timeoutInSeconds
 # value: 20
 # 存储状态的表名（可选）
 #- name: tableName
 # value: "state"
 # Dapr 使用的元数据存储表名（可选）
 #- name: metadataTableName
 # value: "dapr_metadata"
 # 清理过期行的间隔时间，以秒为单位（可选）
 #- name: cleanupIntervalInSeconds
 # value: 3600
 # 连接关闭前的最大空闲时间（可选）
 #- name: connectionMaxIdleTime
 # value: 0
 # 如果希望使用 CockroachDB 作为 actor 的状态存储，请取消注释此行（可选）
 #- name: actorStateStore
 # value: "true"

警告

上述示例中使用了明文字符串来存储 secret。建议使用 secret 存储来保护 secret，如此处所述。

规格元数据字段

字段	必需	详情	示例
`connectionString`	Y	CockroachDB 的连接字符串	`"host=localhost user=root port=26257 connect_timeout=10 database=dapr_test"`
`timeoutInSeconds`	N	所有数据库操作的超时时间，以秒为单位。默认值为 `20`	`30`
`tableName`	N	存储数据的表名。默认值为 `state`。可以选择性地在前面加上模式名称，如 `public.state`	`"state"`, `"public.state"`
`metadataTableName`	N	Dapr 用于存储一些元数据属性的表名。默认值为 `dapr_metadata`。可以选择性地在前面加上模式名称，如 `public.dapr_metadata`	`"dapr_metadata"`, `"public.dapr_metadata"`
`cleanupIntervalInSeconds`	N	清理具有过期 TTL 的行的间隔时间，以秒为单位。默认值：`3600`（即 1 小时）。将此值设置为 <=0 可禁用定期清理。	`1800`, `-1`
`connectionMaxIdleTime`	N	在连接池中未使用的连接自动关闭前的最大空闲时间。默认情况下，没有值，由数据库驱动程序选择。	`"5m"`
`actorStateStore`	N	将此状态存储视为 actor 的状态存储。默认值为 `"false"`	`"true"`, `"false"`

设置 CockroachDB

运行一个 CockroachDB 实例。您可以使用以下命令在 Docker CE 中运行 CockroachDB 的本地实例：

Couchbase

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

组件格式

要设置 Couchbase 状态存储，需要创建一个类型为 state.couchbase 的组件。请参阅本指南以了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.couchbase
 version: v1
 metadata:
 - name: couchbaseURL
 value: <REPLACE-WITH-URL> # 必填。示例: "http://localhost:8091"
 - name: username
 value: <REPLACE-WITH-USERNAME> # 必填。
 - name: password
 value: <REPLACE-WITH-PASSWORD> # 必填。
 - name: bucketName
 value: <REPLACE-WITH-BUCKET> # 必填。

警告

上述示例中，secret 是以明文字符串形式使用的。建议使用 secret 存储来保护这些信息，具体方法请参阅此处。

配置元数据字段

字段	必填	详情	示例
couchbaseURL	Y	Couchbase 服务器的 URL	`"http://localhost:8091"`
username	Y	数据库的用户名	`"user"`
password	Y	访问的密码	`"password"`
bucketName	Y	要写入的桶名称	`"bucket"`

设置 Couchbase

您可以使用 Docker 在本地运行 Couchbase：

Etcd

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

组件格式

要配置 Etcd 状态存储，需创建一个类型为 state.etcd 的组件。请参阅本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.etcd
 # 支持 v1 和 v2。建议默认使用 v2。请注意，v1 和 v2 之间没有直接的迁移路径，详情请参见下文的 `版本控制`。
 version: v2
 metadata:
 - name: endpoints
 value: <CONNECTION STRING> # 必需。示例：192.168.0.1:2379,192.168.0.2:2379,192.168.0.3:2379
 - name: keyPrefixPath
 value: <KEY PREFIX STRING> # 可选。默认值：""。示例："dapr"
 - name: tlsEnable
 value: <ENABLE TLS> # 可选。示例："false"
 - name: ca
 value: <CA> # 可选。如果 tlsEnable 为 `true`，则必需。
 - name: cert
 value: <CERT> # 可选。如果 tlsEnable 为 `true`，则必需。
 - name: key
 value: <KEY> # 可选。如果 tlsEnable 为 `true`，则必需。
 # 如果希望将 Etcd 用作 actor 的状态存储，请取消注释此行（可选）
 #- name: actorStateStore
 # value: "true"

警告

上述示例使用明文字符串作为 secret。建议按照此处的说明使用 secret 存储。

版本控制

Dapr 提供了两个版本的 Etcd 状态存储组件：v1 和 v2。建议使用 v2，因为 v1 已被弃用。

GCP Firestore（Datastore 模式）

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

组件格式

要设置 GCP Firestore 状态存储组件，请创建一个类型为 state.gcp.firestore 的组件。请参阅本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.gcp.firestore
 version: v1
 metadata:
 - name: project_id
 value: <REPLACE-WITH-PROJECT-ID> # 必填。
 - name: endpoint # 可选。
 value: "http://localhost:8432"
 - name: private_key_id
 value: <REPLACE-WITH-PRIVATE-KEY-ID> # 可选。
 - name: private_key
 value: <REPLACE-WITH-PRIVATE-KEY> # 可选，但如果指定了 `private_key_id` 则必填。
 - name: client_email
 value: <REPLACE-WITH-CLIENT-EMAIL> # 可选，但如果指定了 `private_key_id` 则必填。
 - name: client_id
 value: <REPLACE-WITH-CLIENT-ID> # 可选，但如果指定了 `private_key_id` 则必填。
 - name: auth_uri
 value: <REPLACE-WITH-AUTH-URI> # 可选。
 - name: token_uri
 value: <REPLACE-WITH-TOKEN-URI> # 可选。
 - name: auth_provider_x509_cert_url
 value: <REPLACE-WITH-AUTH-X509-CERT-URL> # 可选。
 - name: client_x509_cert_url
 value: <REPLACE-WITH-CLIENT-x509-CERT-URL> # 可选。
 - name: entity_kind
 value: <REPLACE-WITH-ENTITY-KIND> # 可选。默认值："DaprState"
 - name: noindex
 value: <REPLACE-WITH-BOOLEAN> # 可选。默认值："false"
 - name: type 
 value: <REPLACE-WITH-CREDENTIALS-TYPE> # 已弃用。

警告

上述示例中，secret 以明文字符串形式使用。建议使用 secret 存储来保护这些信息，具体方法请参阅此处。

规格元数据字段

字段	必填	说明	示例
project_id	Y	使用的 GCP 项目的 ID	`"project-id"`
endpoint	N	组件使用的 GCP 端点，仅用于本地开发（例如使用 GCP Datastore Emulator）。在生产环境中不需要设置 `endpoint`。	`"localhost:8432"`
private_key_id	N	使用的私钥 ID	`"private-key-id"`
private_key	N	如果使用显式凭据，此字段应包含服务账户 JSON 中的 `private_key` 字段	`-----BEGIN PRIVATE KEY-----MIIBVgIBADANBgkqhkiG9w0B`
client_email	N	客户端的电子邮件地址	`"example@example.com"`
client_id	N	用于身份验证的客户端 ID	`"client-id"`
auth_uri	N	使用的身份验证 URI	`"https://accounts.google.com/o/oauth2/auth"`
token_uri	N	用于获取 Auth 令牌的 URI	`"https://oauth2.googleapis.com/token"`
auth_provider_x509_cert_url	N	身份验证提供者的证书 URL	`"https://www.googleapis.com/oauth2/v1/certs"`
client_x509_cert_url	N	客户端证书 URL	`"https://www.googleapis.com/robot/v1/metadata/x509/x"`
entity_kind	N	Filestore 中的实体名称，默认为 `"DaprState"`	`"DaprState"`
noindex	N	是否禁用状态实体的索引。如果遇到 Firestore 索引大小限制，可以启用此设置。默认为 `"false"`	`"true"`
type	N	已弃用凭据类型	`"serviceaccount"`

GCP 凭据

由于 GCP Firestore 组件使用 GCP Go 客户端库，默认情况下会使用 应用程序默认凭据 进行身份验证。详细信息请参阅使用客户端库对 GCP 云服务进行身份验证指南。

HashiCorp Consul

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

组件格式

要配置 HashiCorp Consul 状态存储，创建一个类型为 state.consul 的组件。请参考本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.consul
 version: v1
 metadata:
 - name: datacenter
 value: <REPLACE-WITH-DATA-CENTER> # 必需。示例: dc1
 - name: httpAddr
 value: <REPLACE-WITH-CONSUL-HTTP-ADDRESS> # 必需。示例: "consul.default.svc.cluster.local:8500"
 - name: aclToken
 value: <REPLACE-WITH-ACL-TOKEN> # 可选。默认: ""
 - name: scheme
 value: <REPLACE-WITH-SCHEME> # 可选。默认: "http"
 - name: keyPrefixPath
 value: <REPLACE-WITH-TABLE> # 可选。默认: ""

警告

上述示例中，secret 使用了明文字符串。建议使用 secret 存储来保护 secret，如此处所述。

规范元数据字段

字段	必需	详情	示例
datacenter	Y	使用的数据中心	`"dc1"`
httpAddr	Y	Consul 服务器的地址	`"consul.default.svc.cluster.local:8500"`
aclToken	N	每个请求的 ACL 令牌。默认是 `""`	`"token"`
scheme	N	Consul 服务器的 URI 方案。默认是 `"http"`	`"http"`
keyPrefixPath	N	Consul 中的键前缀路径。默认是 `""`	`"dapr"`

设置 HashiCorp Consul

您可以使用 Docker 在本地运行 Consul：

Hazelcast

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

创建一个 Dapr 组件

要配置 Hazelcast 状态存储，请创建一个类型为 state.hazelcast 的组件。请参阅本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.hazelcast
 version: v1
 metadata:
 - name: hazelcastServers
 value: <REPLACE-WITH-HOSTS> # 必需。服务器地址的逗号分隔字符串。例如："hazelcast:3000,hazelcast2:3000"
 - name: hazelcastMap
 value: <REPLACE-WITH-MAP> # 必需。Hazelcast map 的配置。

警告

上述示例中使用了明文字符串来表示 secret。建议使用 secret 存储来保护这些信息，具体方法请参阅此处。

规格元数据字段

字段	必需	详情	示例
hazelcastServers	是	服务器地址的逗号分隔字符串	`"hazelcast:3000,hazelcast2:3000"`
hazelcastMap	是	Hazelcast map 的配置	`"foo-map"`

设置 Hazelcast

您可以使用 Docker 在本地运行 Hazelcast：

JetStream KV

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

组件格式

要设置 JetStream KV 状态存储，请创建一个类型为 state.jetstream 的组件。有关如何创建和应用状态存储配置的详细步骤，请参阅本指南。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.jetstream
 version: v1
 metadata:
 - name: natsURL
 value: "nats://localhost:4222"
 - name: jwt
 value: "eyJhbGciOiJ...6yJV_adQssw5c" # 可选。用于分布式 JWT 认证
 - name: seedKey
 value: "SUACS34K232O...5Z3POU7BNIL4Y" # 可选。用于分布式 JWT 认证
 - name: bucket
 value: "<bucketName>"

警告

上述示例中使用了明文字符串作为 secret。建议使用 secret 存储来保护这些信息，具体方法请参阅此处。

规格元数据字段说明

字段	必需	详情	示例
natsURL	是	NATS 服务器地址 URL	“`nats://localhost:4222`”
jwt	否	用于分布式认证的 NATS JWT	“`eyJhbGciOiJ...6yJV_adQssw5c`”
seedKey	否	用于分布式认证的 NATS 种子密钥	“`SUACS34K232O...5Z3POU7BNIL4Y`”
bucket	是	JetStream KV 桶名称	`"<bucketName>"`

创建 NATS 服务器

您可以使用 Docker 在本地运行启用 JetStream 的 NATS 服务器：

Memcached

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

组件格式

要配置 Memcached 状态存储，需创建一个类型为 state.memcached 的组件。请参阅本指南以了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.memcached
 version: v1
 metadata:
 - name: hosts
 value: <REPLACE-WITH-COMMA-DELIMITED-ENDPOINTS> # 必需。示例: "memcached.default.svc.cluster.local:11211"
 - name: maxIdleConnections
 value: <REPLACE-WITH-MAX-IDLE-CONNECTIONS> # 可选。默认值: "2"
 - name: timeout
 value: <REPLACE-WITH-TIMEOUT> # 可选。默认值: "1000"

警告

上述示例中使用了明文字符串作为密钥。建议使用密钥存储来保护密钥，详情请参阅此处。

规格元数据字段

字段	必需	详情	示例
hosts	Y	逗号分隔的端点	`"memcached.default.svc.cluster.local:11211"`
maxIdleConnections	N	最大空闲连接数。默认为 `"2"`	`"3"`
timeout	N	调用的超时时间（毫秒）。默认为 `"1000"`	`"1000"`

设置 Memcached

您可以使用 Docker 在本地运行 Memcached：

Microsoft SQL Server & Azure SQL

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

组件格式

该状态存储组件适用于 Microsoft SQL Server 和 Azure SQL。

要配置此状态存储，请创建一个类型为 state.sqlserver 的组件。请参考本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.sqlserver
 version: v1
 metadata:
 # 使用 SQL Server 凭据进行身份验证
 - name: connectionString
 value: |
 Server=myServerName\myInstanceName;Database=myDataBase;User Id=myUsername;Password=myPassword;

 # 使用 Microsoft Entra ID 进行身份验证（仅限 Azure SQL）
 # "useAzureAD" 设置为 "true"
 - name: useAzureAD
 value: true
 # Azure SQL 数据库的连接字符串或 URL，可选包含数据库
 - name: connectionString
 value: |
 sqlserver://myServerName.database.windows.net:1433?database=myDataBase

 # 其他可选字段（列出默认值）
 - name: tableName
 value: "state"
 - name: metadataTableName
 value: "dapr_metadata"
 - name: schema
 value: "dbo"
 - name: keyType
 value: "string"
 - name: keyLength
 value: "200"
 - name: indexedProperties
 value: ""
 - name: cleanupIntervalInSeconds
 value: "3600"
 # 如果希望使用 Microsoft SQL Server 作为 actor 的状态存储，请取消注释此行（可选）
 #- name: actorStateStore
 # value: "true"

警告

上述示例中使用了明文字符串作为密钥。建议使用密钥存储来保护密钥，具体方法请参见此处。

如果希望将 SQL Server 用作 actor 状态存储，请在元数据中添加以下内容：

MongoDB

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

组件格式

为了设置MongoDB状态存储，您需要创建一个类型为state.mongodb的组件。请参考本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.mongodb
 version: v1
 metadata:
 - name: server
 value: <REPLACE-WITH-SERVER> # 必填，除非设置了"host"字段。例如："server.example.com"
 - name: host
 value: <REPLACE-WITH-HOST> # 必填，除非设置了"server"字段。例如："mongo-mongodb.default.svc.cluster.local:27017"
 - name: username
 value: <REPLACE-WITH-USERNAME> # 可选。例如："admin"
 - name: password
 value: <REPLACE-WITH-PASSWORD> # 可选。
 - name: databaseName
 value: <REPLACE-WITH-DATABASE-NAME> # 可选。默认值："daprStore"
 - name: collectionName
 value: <REPLACE-WITH-COLLECTION-NAME> # 可选。默认值："daprCollection"
 - name: writeConcern
 value: <REPLACE-WITH-WRITE-CONCERN> # 可选。
 - name: readConcern
 value: <REPLACE-WITH-READ-CONCERN> # 可选。
 - name: operationTimeout
 value: <REPLACE-WITH-OPERATION-TIMEOUT> # 可选。默认值："5s"
 - name: params
 value: <REPLACE-WITH-ADDITIONAL-PARAMETERS> # 可选。例如："?authSource=daprStore&ssl=true"
 # 如果希望将MongoDB用作actor的状态存储，请取消注释此行（可选）
 #- name: actorStateStore
 # value: "true"

警告

上述示例中，secret以明文字符串形式使用。建议按照此处所述使用secret存储。

actor状态存储和事务支持

当MongoDB用作actor状态存储或需要事务支持时，必须在副本集中运行。

MySQL & MariaDB

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

组件格式

MySQL 状态存储组件允许连接到 MySQL 和 MariaDB 数据库。在本文档中，“MySQL” 代表这两个数据库。

要设置 MySQL 状态存储，请创建一个类型为 state.mysql 的组件。请参考本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.mysql
 version: v1
 metadata:
 - name: connectionString
 value: "<CONNECTION STRING>"
 - name: schemaName
 value: "<SCHEMA NAME>"
 - name: tableName
 value: "<TABLE NAME>"
 - name: timeoutInSeconds
 value: "30"
 - name: pemPath # 如果未提供 pemContents，则为必需。pem 文件的路径。
 value: "<PEM PATH>"
 - name: pemContents # 如果未提供 pemPath，则为必需。pem 值。
 value: "<PEM CONTENTS>" 
# 如果希望将 MySQL & MariaDB 用作 actor 的状态存储，请取消注释此行（可选）
 #- name: actorStateStore
 # value: "true"

警告

上述示例中，secret 使用了明文字符串。建议使用 secret 存储来存储 secret，如此处所述。

如果希望将 MySQL 用作 actor 存储，请在 yaml 中添加以下配置。

OCI 对象存储

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

组件格式

要配置 OCI 对象存储状态存储，请创建一个类型为 state.oci.objectstorage 的组件。请参阅本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.oci.objectstorage
 version: v1
 metadata:
 - name: instancePrincipalAuthentication
 value: <"true" 或 "false">  # 可选。默认值："false"
 - name: configFileAuthentication
 value: <"true" 或 "false">  # 可选。默认值："false"。当 instancePrincipalAuthentication 为 "true" 时不使用
 - name: configFilePath
 value: <配置文件的完整路径>  # 可选。无默认值。仅在 configFileAuthentication 为 "true" 时使用
 - name: configFileProfile
 value: <配置文件中的配置名称>  # 可选。默认值："DEFAULT"。仅在 configFileAuthentication 为 "true" 时使用
 - name: tenancyOCID
 value: <租户的 OCID>  # 当 configFileAuthentication 为 "true" 或 instancePrincipalAuthentication 为 "true" 时不使用
 - name: userOCID
 value: <用户的 OCID>  # 当 configFileAuthentication 为 "true" 或 instancePrincipalAuthentication 为 "true" 时不使用
 - name: fingerPrint
 value: <公钥的指纹>  # 当 configFileAuthentication 为 "true" 或 instancePrincipalAuthentication 为 "true" 时不使用
 - name: privateKey  # 当 configFileAuthentication 为 "true" 或 instancePrincipalAuthentication 为 "true" 时不使用
 value: |
 -----BEGIN RSA PRIVATE KEY-----
 私钥内容
 -----END RSA PRIVATE KEY-----
 - name: region
 value: <OCI 区域>  # 当 configFileAuthentication 为 "true" 或 instancePrincipalAuthentication 为 "true" 时不使用
 - name: bucketName
 value: <桶的名称>
 - name: compartmentOCID
 value: <隔间的 OCID>

警告

上述示例使用明文字符串作为密钥。建议使用密钥存储来保护密钥，如此处所述。

规格元数据字段

字段	必需	详细信息	示例
instancePrincipalAuthentication	否	布尔值，指示是否使用实例主体认证。默认值：“false”	`"true"` 或 `"false"`。
configFileAuthentication	否	布尔值，指示是否通过配置文件提供身份凭证。默认值：“false”。当 instancePrincipalAuthentication 为 true 时不使用。	`"true"` 或 `"false"`。
configFilePath	否	OCI 配置文件的完整路径。无默认值。当 instancePrincipalAuthentication 为 true 时不使用。请注意：不支持 ~/ 前缀。	`"/home/apps/configuration-files/myOCIConfig.txt"`。
configFileProfile	否	配置文件中的配置名称。默认值：“DEFAULT”。当 instancePrincipalAuthentication 为 true 时不使用。	`"DEFAULT"` 或 `"PRODUCTION"`。
tenancyOCID	是	OCI 租户标识符。当 instancePrincipalAuthentication 为 true 时不使用。	`"ocid1.tenancy.oc1..aaaaaaaag7c7sljhsdjhsdyuwe723"`。
userOCID	是	OCI 用户的 OCID（需要访问 OCI 对象存储的权限）。当 instancePrincipalAuthentication 为 true 时不使用。	`"ocid1.user.oc1..aaaaaaaaby4oyyyuqwy7623yuwe76"`
fingerPrint	是	公钥的指纹。当 instancePrincipalAuthentication 为 true 时不使用。	`"02:91:6c:49:e2:94:21:15:a7:6b:0e:a7:34:e1:3d:1b"`
privateKey	是	RSA 密钥对的私钥。当 instancePrincipalAuthentication 为 true 时不使用。	`"MIIEoyuweHAFGFG2727as+7BTwQRAIW4V"`
region	是	OCI 区域。当 instancePrincipalAuthentication 为 true 时不使用。	`"us-ashburn-1"`
bucketName	是	用于读写的桶的名称（如果需要则创建）	`"application-state-store-bucket"`
compartmentOCID	是	包含桶的隔间的 OCID	`"ocid1.compartment.oc1..aaaaaaaacsssekayyuq7asjh78"`

设置 OCI 对象存储

OCI 对象存储状态存储需要与 Oracle 云基础设施交互。状态存储支持两种认证方法：基于身份（用户或服务账户）的认证和实例主体认证。请注意，资源主体认证（用于非实例的资源，如无服务器函数）目前不支持。

Oracle 数据库

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

组件格式

创建一个组件属性的 yaml 文件，例如 oracle.yaml（名称可以随意），然后粘贴以下内容，并将 <CONNECTION STRING> 替换为您的连接字符串。连接字符串是标准的 Oracle 数据库连接字符串，格式为："oracle://user/password@host:port/servicename"，例如 "oracle://demo:demo@localhost:1521/xe"。

如果您通过 Oracle Wallet 连接数据库，则应为 oracleWalletLocation 属性指定一个值，例如："/home/app/state/Wallet_daprDB/"；这应该指向本地文件系统目录，该目录包含从 Oracle Wallet 压缩文件中提取的 cwallet.sso 文件。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.oracledatabase
 version: v1
 metadata:
 - name: connectionString
 value: "<CONNECTION STRING>"
 - name: oracleWalletLocation
 value: "<FULL PATH TO DIRECTORY WITH ORACLE WALLET CONTENTS >" # 可选，无默认值
 - name: tableName
 value: "<NAME OF DATABASE TABLE TO STORE STATE IN >" # 可选，默认为 STATE
 # 如果您希望使用 Oracle 数据库作为 actor 的状态存储，请取消注释此行（可选）
 #- name: actorStateStore
 # value: "true"

警告

上述示例中使用了明文字符串作为 secret。建议使用 secret 存储来存储 secret，如此处所述。

规格元数据字段

字段	必需	详细信息	示例
connectionString	Y	Oracle 数据库的连接字符串	`"oracle://user/password@host:port/servicename"` 例如 `"oracle://demo:demo@localhost:1521/xe"` 或对于 Autonomous Database `"oracle://states_schema:State12345pw@adb.us-ashburn-1.oraclecloud.com:1522/k8j2agsqjsw_daprdb_low.adb.oraclecloud.com"`
oracleWalletLocation	N	Oracle Wallet 文件内容的位置（连接到 OCI 上的 Autonomous Database 时需要）	`"/home/app/state/Wallet_daprDB/"`
tableName	N	此状态存储实例记录数据的数据库表的名称，默认 `"STATE"`	`"MY_APP_STATE_STORE"`
actorStateStore	N	考虑此状态存储用于 actor。默认为 `"false"`	`"true"`, `"false"`

运行时会发生什么？

当状态存储组件初始化时，它会连接到 Oracle 数据库并检查是否存在指定 tableName 的表。如果不存在，它会创建此表（包含列 Key, Value, Binary_YN, ETag, Creation_Time, Update_Time, Expiration_time）。

PostgreSQL

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

注意

这是 PostgreSQL 状态存储组件的 v2 版，包含了一些性能和可靠性方面的改进。建议新应用使用 v2。

PostgreSQL v2 状态存储组件与 v1 组件不兼容，数据无法在两个版本之间迁移。v2 组件不支持状态存储查询 API。

目前没有计划弃用 v1 组件。

此组件允许使用 PostgreSQL (Postgres) 作为 Dapr 的状态存储，采用 “v2” 组件。请参阅本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.postgresql
 # 注意：设置 "version" 为 "v2" 是使用 v2 组件所必需的
 version: v2
 metadata:
 # 连接字符串
 - name: connectionString
 value: "<CONNECTION STRING>"
 # 数据库操作的超时时间，作为 Go duration 或秒数（可选）
 #- name: timeout
 # value: 20
 # 存储数据的表的前缀（可选）
 #- name: tablePrefix
 # value: ""
 # 存储 Dapr 使用的元数据的表名（可选）
 #- name: metadataTableName
 # value: "dapr_metadata"
 # 清理过期行的间隔时间，以秒为单位（可选）
 #- name: cleanupInterval
 # value: "1h"
 # 该组件池化的最大连接数（可选）
 #- name: maxConns
 # value: 0
 # 连接在关闭前的最大空闲时间（可选）
 #- name: connectionMaxIdleTime
 # value: 0
 # 控制执行查询的默认模式。（可选）
 #- name: queryExecMode
 # value: ""
 # 如果希望使用 PostgreSQL 作为 actor 或 workflow 的状态存储，请取消注释此项（可选）
 #- name: actorStateStore
 # value: "true"

警告

上述示例使用明文字符串作为 secret。建议按照此处所述使用 secret 存储。

规格元数据字段

使用连接字符串进行身份验证

以下元数据选项是使用 PostgreSQL 连接字符串进行身份验证所必需的。

PostgreSQL v1

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

注意

从 Dapr 1.13 开始，您可以使用 PostgreSQL v2 状态存储组件，该组件在性能和可靠性方面有所提升。
v2 组件与 v1 不兼容，数据无法在两个组件之间迁移。v2 组件不支持状态存储查询 API。

目前没有计划弃用 v1 组件。

此组件允许使用 PostgreSQL (Postgres) 作为 Dapr 的状态存储，采用 “v1” 组件。请参考本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.postgresql
 version: v1
 metadata:
 # 连接字符串
 - name: connectionString
 value: "<CONNECTION STRING>"
 # 数据库操作的超时时间，作为 Go duration 或秒数（可选）
 #- name: timeout
 # value: 20
 # 存储状态的表名（可选）
 #- name: tableName
 # value: "state"
 # 存储 Dapr 使用的元数据的表名（可选）
 #- name: metadataTableName
 # value: "dapr_metadata"
 # 清理过期行的间隔时间，以秒为单位（可选）
 #- name: cleanupInterval
 # value: "1h"
 # 该组件池化的最大连接数（可选）
 #- name: maxConns
 # value: 0
 # 连接在关闭前的最大空闲时间（可选）
 #- name: connectionMaxIdleTime
 # value: 0
 # 控制查询执行的默认模式。（可选）
 #- name: queryExecMode
 # value: ""
 # 如果希望使用 PostgreSQL 作为 actor 或 workflow 的状态存储，请取消注释此项（可选）
 #- name: actorStateStore
 # value: "true"

警告

上述示例使用明文字符串作为 secret。建议按照此处所述使用 secret 存储。

规格元数据字段

使用连接字符串进行身份验证

以下元数据选项是使用 PostgreSQL 连接字符串进行身份验证所必需的。

Redis

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

组件格式

要配置 Redis 状态存储，需创建一个类型为 state.redis 的组件。参见本指南以了解如何创建和应用状态存储配置。

限制

在使用 Redis 和事务 API 之前，请确保您熟悉 Redis 关于事务的限制。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.redis
 version: v1
 metadata:
 - name: redisHost
 value: <HOST>
 - name: redisPassword # 可选。
 value: <PASSWORD>
 - name: useEntraID
 value: <bool> # 可选。允许值：true, false。
 - name: enableTLS
 value: <bool> # 可选。允许值：true, false。
 - name: clientCert
 value: # 可选
 - name: clientKey
 value: # 可选 
 - name: maxRetries
 value: # 可选
 - name: maxRetryBackoff
 value: # 可选
 - name: failover
 value: <bool> # 可选。允许值：true, false。
 - name: sentinelMasterName
 value: <string> # 可选
 - name: redeliverInterval
 value: # 可选
 - name: processingTimeout
 value: # 可选
 - name: redisType
 value: # 可选
 - name: redisDB
 value: # 可选
 - name: redisMaxRetries
 value: # 可选
 - name: redisMinRetryInterval
 value: # 可选
 - name: redisMaxRetryInterval
 value: # 可选
 - name: dialTimeout
 value: # 可选
 - name: readTimeout
 value: # 可选
 - name: writeTimeout
 value: # 可选
 - name: poolSize
 value: # 可选
 - name: poolTimeout
 value: # 可选
 - name: maxConnAge
 value: # 可选
 - name: minIdleConns
 value: # 可选
 - name: idleCheckFrequency
 value: # 可选
 - name: idleTimeout
 value: # 可选
 - name: ttlInSeconds
 value: <int> # 可选
 - name: queryIndexes
 value: <string> # 可选
 # 如果希望将 Redis 用作 actor 的状态存储，请取消注释以下内容（可选）
 #- name: actorStateStore
 # value: "true"

警告

上述示例使用明文字符串作为 secret。建议使用 secret 存储来存储 secret，如此处所述。

如果希望将 Redis 用作 actor 存储，请在 yaml 中添加以下内容。

RethinkDB

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

组件格式

要配置 RethinkDB 状态存储，创建一个类型为 state.rethinkdb 的组件。请参阅操作指南以创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.rethinkdb
 version: v1
 metadata:
 - name: address
 value: <REPLACE-RETHINKDB-ADDRESS> # 必需，例如 127.0.0.1:28015 或 rethinkdb.default.svc.cluster.local:28015。
 - name: database
 value: <REPLACE-RETHINKDB-DB-NAME> # 必需，例如 dapr（仅限字母数字）
 - name: table
 value: # 可选
 - name: username
 value: <USERNAME> # 可选
 - name: password
 value: <PASSWORD> # 可选
 - name: archive
 value: bool # 可选（是否保留所有状态更改的存档表）

警告

上述示例中，secret 以明文字符串形式使用。建议使用 secret 存储来存储 secret，如此处所述。

如果可选的 archive 元数据设置为 true，则每次状态更改时，RethinkDB 状态存储还将在 daprstate_archive 表中记录带有时间戳的状态更改。这允许对 Dapr 管理的状态进行时间序列分析。

SQLite

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

此组件支持使用 SQLite 3 作为 Dapr 的状态存储。

该组件目前使用 SQLite 版本 3.41.2 编译。

创建一个 Dapr 组件

创建一个名为 sqlite.yaml 的文件，并粘贴以下内容，将 <CONNECTION STRING> 替换为您的连接字符串，即磁盘上文件的路径。

如果您还想配置 SQLite 来存储 actor，请在下例中添加 actorStateStore 选项。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.sqlite
 version: v1
 metadata:
 # 连接字符串
 - name: connectionString
 value: "data.db"
 # 数据库操作的超时时间，以秒为单位（可选）
 #- name: timeoutInSeconds
 # value: 20
 # 存储状态的表名（可选）
 #- name: tableName
 # value: "state"
 # 清理过期行的间隔时间，以秒为单位（可选）
 #- name: cleanupInterval
 # value: "1h"
 # 设置数据库操作的忙等待时间
 #- name: busyTimeout
 # value: "2s"
 # 如果希望使用 SQLite 作为 actor 的状态存储，请取消注释此行（可选）
 #- name: actorStateStore
 # value: "true"

规格元数据字段

字段	必需	详情	示例
`connectionString`	Y	SQLite 数据库的连接字符串。详见下文。	`"path/to/data.db"`, `"file::memory:?cache=shared"`
`timeout`	N	数据库操作的超时时间，格式为 Go duration。整数被解释为秒数。默认值为 `20s`	`"30s"`, `30`
`tableName`	N	存储数据的表名。默认值为 `state`。	`"state"`
`metadataTableName`	N	Dapr 用于存储组件元数据的表名。默认值为 `metadata`。	`"metadata"`
`cleanupInterval`	N	清理过期 TTL 行的间隔时间，格式为 Go duration。设置为 <=0 的值将禁用定期清理。默认值：`0`（即禁用）	`"2h"`, `"30m"`, `-1`
`busyTimeout`	N	在 SQLite 数据库当前忙于处理其他请求时等待的时间间隔，格式为 Go duration，然后返回“数据库忙”错误。默认值：`2s`	`"100ms"`, `"5s"`
`disableWAL`	N	如果设置为 true，则禁用 SQLite 数据库的预写日志记录。若数据库存储在网络文件系统上（例如，作为 SMB 或 NFS 共享挂载的文件夹），应将此设置为 `false`。此选项在只读或内存数据库中被忽略。	`"true"`, `"false"`
`actorStateStore`	N	将此状态存储视为 actor 的状态存储。默认值为 `"false"`	`"true"`, `"false"`

connectionString 参数用于配置如何打开 SQLite 数据库。

Zookeeper

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

组件格式说明

要设置 Zookeeper 状态存储，您需要创建一个类型为 state.zookeeper 的组件。请参考本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.zookeeper
 version: v1
 metadata:
 - name: servers
 value: <REPLACE-WITH-COMMA-DELIMITED-SERVERS> # 必需。示例: "zookeeper.default.svc.cluster.local:2181"
 - name: sessionTimeout
 value: <REPLACE-WITH-SESSION-TIMEOUT> # 必需。示例: "5s"
 - name: maxBufferSize
 value: <REPLACE-WITH-MAX-BUFFER-SIZE> # 可选。默认: "1048576"
 - name: maxConnBufferSize
 value: <REPLACE-WITH-MAX-CONN-BUFFER-SIZE> # 可选。默认: "1048576"
 - name: keyPrefixPath
 value: <REPLACE-WITH-KEY-PREFIX-PATH> # 可选。

警告

上述示例中使用了明文字符串来表示 secret。建议使用 secret 存储来安全地管理这些 secret，详情请参阅此处。

规格元数据字段

字段	必需	详情	示例
servers	Y	逗号分隔的服务器列表	`"zookeeper.default.svc.cluster.local:2181"`
sessionTimeout	Y	会话超时时间	`"5s"`
maxBufferSize	N	缓冲区的最大大小，默认值为 `"1048576"`	`"1048576"`
maxConnBufferSize	N	连接缓冲区的最大大小，默认值为 `"1048576"`	`"1048576"`
keyPrefixPath	N	Zookeeper 中的键前缀路径，无默认值	`"dapr"`

设置 Zookeeper

您可以使用 Docker 在本地运行 Zookeeper：

内存

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

内存状态存储组件在Dapr sidecar中维护状态，主要用于开发目的。状态不会在多个sidecar之间共享，并且在Dapr sidecar重启时会丢失。

组件格式

要设置内存状态存储，创建一个类型为state.in-memory的组件。请参阅本指南了解如何创建和应用状态存储配置。

apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
 name: <NAME>
spec:
 type: state.in-memory
 version: v1
 metadata: 
 # 如果希望将内存用作actor模型的状态存储，请取消注释此行（可选）
 #- name: actorStateStore
 # value: "true"

注意：虽然内存组件不需要特定的元数据，但spec.metadata字段仍然是必填的。