Azure Table Storage
Type: state.azure.tablestorage
Status: stable
Reference: https://docs.dapr.io/reference/components-reference/supported-state-stores/setup-azure-tablestorage/
Example
apiVersion: cra.diagrid.io/v1beta1
kind: Component
metadata:
name: <name>
spec:
type: state.azure.tablestorage
version: v1
metadata:
# The key to authenticate to the Storage Account or Cosmos DB Table API.
- name: accountKey
value: "my-secret-key"
# The storage account name.
- name: accountName
value: "mystorageaccount"
# The name of the table to be used for Dapr state. The table will be created for you if it doesn't exist.
- name: tableName
value: "table"
# If enabled, connects to Cosmos DB Table API instead of Azure Tables (Storage Accounts). Defaults to `false`. (Optional)
#- name: cosmosDbMode
# value: "false"
# Prefix added to keys in the state store. (Optional)
#- name: keyPrefix
# value: "appid"
# The full storage service endpoint URL. Useful for Azure environments other than public cloud. (Optional)
#- name: serviceURL
# value: "https://mystorageaccount.table.core.windows.net/"
# Skips the check for and, if necessary, creation of the specified storage table. This is useful when using active directory authentication with minimal privileges. Defaults to `false`. (Optional)
#- name: skipCreateTable
# value: "false"
Authentication profiles
Available authentication profiles:
-
Account Key
-
Azure AD: Client credentials
-
Azure AD: Client certificate
Account Key
Authenticate using a pre-shared "account key".
accountKey
Required - The key to authenticate to the Storage Account or Cosmos DB Table API.
Example value: my-secret-key
Azure AD: Client credentials
Authenticate using Azure AD with client credentials, also known as "service principals".
azureClientId
Required - Client ID (application ID)
Example value: c7dd251f-811f-4ba2-a905-acd4d3f8f08b
azureClientSecret
Required - Client secret (application password)
Example value: Ecy3XG7zVZK3/vl/a2NSB+a1zXLa8RnMum/IgD0E
azureTenantId
Required - ID of the Azure AD tenant
Example value: cd4b2887-304c-47e1-b4d5-65447fdd542a
azureEnvironment
Optional name for the Azure environment if using a different Azure cloud
Default value: AzurePublicCloud
Example value: AzurePublicCloud
Allowed values:
-
AzurePublicCloud
-
AzureChinaCloud
-
AzureUSGovernmentCloud
Azure AD: Client certificate
Authenticate using Azure AD with a client certificate. "azureCertificate" is required.
azureClientId
Required - Client ID (application ID)
Example value: c7dd251f-811f-4ba2-a905-acd4d3f8f08b
azureTenantId
Required - ID of the Azure AD tenant
Example value: cd4b2887-304c-47e1-b4d5-65447fdd542a
azureCertificate
Certificate and private key (in either a PEM file containing both the certificate and key, or in PFX/PKCS#12 format)
Example value:
-----BEGIN PRIVATE KEY-----\n MIIEvgI... \n -----END PRIVATE KEY-----
\n -----BEGIN CERTIFICATE----- \n MIICoTC... \n -----END CERTIFICATE----- \n
azureCertificatePassword
Password for the certificate if encrypted.
Example value: password
azureEnvironment
Optional name for the Azure environment if using a different Azure cloud
Default value: AzurePublicCloud
Example value: AzurePublicCloud
Allowed values:
-
AzurePublicCloud
-
AzureChinaCloud
-
AzureUSGovernmentCloud
Metadata
accountName
(string)
Required - The storage account name.
Example value: mystorageaccount
tableName
(string)
Required - The name of the table to be used for Dapr state. The table will be created for you if it doesn't exist.
Example value: table
cosmosDbMode
(bool)
If enabled, connects to Cosmos DB Table API instead of Azure Tables (Storage Accounts). Defaults to false
.
Default value: false
Example value: false
keyPrefix
(string)
Prefix added to keys in the state store.
Default value: appid
Example value: appid
Allowed values:
-
appid
-
name
-
none
Documentation: https://docs.dapr.io/developing-applications/building-blocks/state-management/howto-share-state/
serviceURL
(string)
The full storage service endpoint URL. Useful for Azure environments other than public cloud.
Example value: https://mystorageaccount.table.core.windows.net/
skipCreateTable
(bool)
Skips the check for and, if necessary, creation of the specified storage table. This is useful when using active directory authentication with minimal privileges. Defaults to false
.
Default value: false
Example value: true