Azure Cosmos DB voor tabelbronnen beheren met Bicep
VAN TOEPASSING OP: Tafel
In dit artikel leert u hoe u Bicep gebruikt om uw Azure Cosmos DB voor tabelaccounts en -tabellen te implementeren en te beheren.
Dit artikel bevat alleen voorbeelden voor API voor Table-accounts. U vindt ook Bicep-voorbeelden voor Cassandra-, Gremlin-, MongoDB-, SQL-artikelen .
Belangrijk
- Accountnamen zijn beperkt tot 44 tekens, allemaal kleine letters.
- Als u de doorvoerwaarden wilt wijzigen, implementeert u de sjabloon opnieuw met bijgewerkte RU/s.
- Wanneer u locaties aan een Azure Cosmos DB-account toevoegt of verwijdert, kunt u andere eigenschappen niet tegelijk wijzigen. Deze bewerkingen moeten afzonderlijk worden uitgevoerd.
Als u een van de onderstaande Azure Cosmos DB-resources wilt maken, kopieert u het volgende voorbeeld naar een nieuw bicep-bestand. U kunt eventueel een parameterbestand maken dat moet worden gebruikt bij het implementeren van meerdere exemplaren van dezelfde resource met verschillende namen en waarden. Er zijn veel manieren om Azure Resource Manager-sjablonen te implementeren, waaronder Azure CLI, Azure PowerShell en Cloud Shell.
Tip
Als u gedeelde doorvoer wilt inschakelen wanneer u API voor Table gebruikt, schakelt u doorvoer op accountniveau in azure Portal in. Gedeelde doorvoer op accountniveau kan niet worden ingesteld met Bicep.
Azure Cosmos DB-account voor tabel met doorvoer voor automatisch schalen
Maak een Azure Cosmos DB-account voor API voor Table met één tabel met doorvoer voor automatisch schalen.
@description('Cosmos DB account name')
param accountName string = 'table-${uniqueString(resourceGroup().id)}'
@description('Location for the Cosmos DB account.')
param location string = resourceGroup().location
@description('The primary region for the Cosmos DB account.')
param primaryRegion string
@description('The secondary region for the Cosmos DB account.')
param secondaryRegion string
@description('The default consistency level of the Cosmos DB account.')
@allowed([
'Eventual'
'ConsistentPrefix'
'Session'
'BoundedStaleness'
'Strong'
])
param defaultConsistencyLevel string = 'Session'
@description('Max stale requests. Required for BoundedStaleness. Valid ranges, Single Region: 10 to 2147483647. Multi Region: 100000 to 2147483647.')
@minValue(10)
@maxValue(2147483647)
param maxStalenessPrefix int = 100000
@description('Max lag time (seconds). Required for BoundedStaleness. Valid ranges, Single Region: 5 to 84600. Multi Region: 300 to 86400.')
@minValue(5)
@maxValue(86400)
param maxIntervalInSeconds int = 300
@description('Enable system managed failover for regions')
param systemManagedFailover bool = true
@description('The name for the table')
param tableName string
@description('Maximum autoscale throughput for the table')
@minValue(1000)
@maxValue(1000000)
param autoscaleMaxThroughput int = 4000
var consistencyPolicy = {
Eventual: {
defaultConsistencyLevel: 'Eventual'
}
ConsistentPrefix: {
defaultConsistencyLevel: 'ConsistentPrefix'
}
Session: {
defaultConsistencyLevel: 'Session'
}
BoundedStaleness: {
defaultConsistencyLevel: 'BoundedStaleness'
maxStalenessPrefix: maxStalenessPrefix
maxIntervalInSeconds: maxIntervalInSeconds
}
Strong: {
defaultConsistencyLevel: 'Strong'
}
}
var locations = [
{
locationName: primaryRegion
failoverPriority: 0
isZoneRedundant: false
}
{
locationName: secondaryRegion
failoverPriority: 1
isZoneRedundant: false
}
]
resource account 'Microsoft.DocumentDB/databaseAccounts@2022-05-15' = {
name: toLower(accountName)
location: location
kind: 'GlobalDocumentDB'
properties: {
capabilities: [
{
name: 'EnableTable'
}
]
consistencyPolicy: consistencyPolicy[defaultConsistencyLevel]
locations: locations
databaseAccountOfferType: 'Standard'
enableAutomaticFailover: systemManagedFailover
}
}
resource table 'Microsoft.DocumentDB/databaseAccounts/tables@2022-05-15' = {
parent: account
name: tableName
properties: {
resource: {
id: tableName
}
options: {
autoscaleSettings: {
maxThroughput: autoscaleMaxThroughput
}
}
}
}
Azure Cosmos DB-account voor Tabel met standaard ingerichte doorvoer
Maak een Azure Cosmos DB-account voor API voor Table met één tabel met standaarddoorvoer.
@description('Cosmos DB account name')
param accountName string = 'table-${uniqueString(resourceGroup().id)}'
@description('Location for the Cosmos DB account.')
param location string = resourceGroup().location
@description('The primary region for the Cosmos DB account.')
param primaryRegion string
@description('The secondary region for the Cosmos DB account.')
param secondaryRegion string
@description('The default consistency level of the Cosmos DB account.')
@allowed([
'Eventual'
'ConsistentPrefix'
'Session'
'BoundedStaleness'
'Strong'
])
param defaultConsistencyLevel string = 'Session'
@description('Max stale requests. Required for BoundedStaleness. Valid ranges, Single Region: 10 to 2147483647. Multi Region: 100000 to 2147483647.')
@minValue(10)
@maxValue(2147483647)
param maxStalenessPrefix int = 100000
@description('Max lag time (seconds). Required for BoundedStaleness. Valid ranges, Single Region: 5 to 84600. Multi Region: 300 to 86400.')
@minValue(5)
@maxValue(86400)
param maxIntervalInSeconds int = 300
@description('Enable system managed failover for regions')
param systemManagedFailover bool = true
@description('The name for the table')
param tableName string
@minValue(400)
@maxValue(1000000)
@description('The throughput for the table')
param throughput int = 400
var consistencyPolicy = {
Eventual: {
defaultConsistencyLevel: 'Eventual'
}
ConsistentPrefix: {
defaultConsistencyLevel: 'ConsistentPrefix'
}
Session: {
defaultConsistencyLevel: 'Session'
}
BoundedStaleness: {
defaultConsistencyLevel: 'BoundedStaleness'
maxStalenessPrefix: maxStalenessPrefix
maxIntervalInSeconds: maxIntervalInSeconds
}
Strong: {
defaultConsistencyLevel: 'Strong'
}
}
var locations = [
{
locationName: primaryRegion
failoverPriority: 0
isZoneRedundant: false
}
{
locationName: secondaryRegion
failoverPriority: 1
isZoneRedundant: false
}
]
resource account 'Microsoft.DocumentDB/databaseAccounts@2022-05-15' = {
name: toLower(accountName)
location: location
kind: 'GlobalDocumentDB'
properties: {
capabilities: [
{
name: 'EnableTable'
}
]
consistencyPolicy: consistencyPolicy[defaultConsistencyLevel]
locations: locations
databaseAccountOfferType: 'Standard'
enableAutomaticFailover: systemManagedFailover
}
}
resource table 'Microsoft.DocumentDB/databaseAccounts/tables@2022-05-15' = {
parent: account
name: tableName
properties: {
resource: {
id: tableName
}
options: {
throughput: throughput
}
}
}
Volgende stappen
Hier volgen enkele aanvullende bronnen: