Zarządzanie zasobami usługi Azure Cosmos DB dla bazy danych Apache Cassandra przy użyciu rozwiązania Bicep
DOTYCZY: 
Kasandra
Z tego artykułu dowiesz się, jak używać rozwiązania Bicep do wdrażania usługi Azure Cosmos DB dla kont, przestrzeni kluczy i tabel apache Cassandra oraz zarządzania nimi.
W tym artykule przedstawiono przykłady Bicep dla interfejsu API dla kont Cassandra. Możesz również znaleźć przykłady Bicep dla interfejsów API sql, Gremlin, MongoDB i Table .
Ważne
- Nazwy kont są ograniczone do 44 znaków, a wszystkie małe litery.
- Aby zmienić wartości przepływności, ponownie wdróż szablon przy użyciu zaktualizowanych jednostek RU/s.
- Podczas dodawania lub usuwania lokalizacji do konta usługi Azure Cosmos DB nie można jednocześnie modyfikować innych właściwości. Te operacje muszą być wykonywane oddzielnie.
Aby utworzyć dowolne z poniższych zasobów usługi Azure Cosmos DB, skopiuj poniższy przykład do nowego pliku bicep. Opcjonalnie można utworzyć plik parametrów do użycia podczas wdrażania wielu wystąpień tego samego zasobu o różnych nazwach i wartościach. Istnieje wiele sposobów wdrażania szablonów usługi Azure Resource Manager, w tym interfejsu wiersza polecenia platformy Azure, programu Azure PowerShell i usługi Cloud Shell.
Interfejs API dla rozwiązania Cassandra z aprowizowaną przepływnością autoskalowania
Utwórz konto usługi Azure Cosmos DB w dwóch regionach z opcjami spójności i trybu failover z przestrzenią kluczy i tabelą skonfigurowaną do automatycznego skalowania przepływności.
@description('Cosmos DB account name, max length 44 characters')
param accountName string = 'cassandra-${uniqueString(resourceGroup().id)}'
@description('Location for the Cosmos DB account.')
param location string = resourceGroup().location
@description('The primary replica region for the Cosmos DB account.')
param primaryRegion string
@description('The secondary replica region for the Cosmos DB account.')
param secondaryRegion string
@allowed([
'Eventual'
'ConsistentPrefix'
'Session'
'BoundedStaleness'
'Strong'
])
@description('The default consistency level of the Cosmos DB account.')
param defaultConsistencyLevel string = 'Eventual'
@minValue(10)
@maxValue(1000000)
@description('Max stale requests. Required for BoundedStaleness. Valid ranges, Single Region: 10 to 2,147,483,647. Multi Region: 100,000 to 2,147,483,647.')
param maxStalenessPrefix int = 100000
@minValue(5)
@maxValue(86400)
@description('Max lag time (seconds). Required for BoundedStaleness. Valid ranges, Single Region: 5 to 84,600. Multi Region: 300 to 86,400.')
param maxIntervalInSeconds int = 300
@allowed([
true
false
])
@description('Enable system managed failover for regions')
param systemManagedFailover bool = true
@description('The name for the Cassandra Keyspace')
param keyspaceName string
@description('The name for the Cassandra table')
param tableName string
@minValue(1000)
@maxValue(1000000)
@description('Maximum autoscale throughput for the Cassandra table')
param autoscaleMaxThroughput int = 1000
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: 'EnableCassandra'
}
]
consistencyPolicy: consistencyPolicy[defaultConsistencyLevel]
locations: locations
databaseAccountOfferType: 'Standard'
enableAutomaticFailover: systemManagedFailover
}
}
resource keyspace 'Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces@2022-05-15' = {
name: '${account.name}/${keyspaceName}'
properties: {
resource: {
id: keyspaceName
}
}
}
resource table 'Microsoft.DocumentDb/databaseAccounts/cassandraKeyspaces/tables@2022-05-15' = {
name: '${keyspace.name}/${tableName}'
properties: {
resource: {
id: tableName
schema: {
columns: [
{
name: 'loadid'
type: 'uuid'
}
{
name: 'machine'
type: 'uuid'
}
{
name: 'cpu'
type: 'int'
}
{
name: 'mtime'
type: 'int'
}
{
name: 'load'
type: 'float'
}
]
partitionKeys: [
{
name: 'machine'
}
{
name: 'cpu'
}
{
name: 'mtime'
}
]
clusterKeys: [
{
name: 'loadid'
orderBy: 'asc'
}
]
}
}
options: {
autoscaleSettings: {
maxThroughput: autoscaleMaxThroughput
}
}
}
}
Interfejs API dla bazy danych Cassandra ze standardową aprowizowaną przepływnością
Utwórz konto usługi Azure Cosmos DB w dwóch regionach z opcjami spójności i trybu failover z przestrzenią kluczy i tabelą skonfigurowaną pod kątem standardowej przepływności.
@description('Cosmos DB account name, max length 44 characters')
param accountName string = 'cassandra-${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
@allowed([
'Eventual'
'ConsistentPrefix'
'Session'
'BoundedStaleness'
'Strong'
])
@description('The default consistency level of the Cosmos DB account.')
param defaultConsistencyLevel string = 'Session'
@minValue(10)
@maxValue(2147483647)
@description('Max stale requests. Required for BoundedStaleness. Valid ranges, Single Region: 10 to 2,147,483,647. Multi Region: 100,000 to 2,147,483,647.')
param maxStalenessPrefix int = 100000
@minValue(5)
@maxValue(86400)
@description('Max lag time (seconds). Required for BoundedStaleness. Valid ranges, Single Region: 5 to 84600. Multi Region: 300 to 86400.')
param maxIntervalInSeconds int = 300
@allowed([
true
false
])
@description('Enable system managed failover for regions')
param systemManagedFailover bool = true
@description('The name for the Cassandra Keyspace')
param keyspaceName string
@description('The name for the Cassandra table')
param tableName string
@minValue(400)
@maxValue(1000000)
@description('The throughput for Cassandra 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: 'EnableCassandra'
}
]
consistencyPolicy: consistencyPolicy[defaultConsistencyLevel]
locations: locations
databaseAccountOfferType: 'Standard'
enableAutomaticFailover: systemManagedFailover
}
}
resource keyspace 'Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces@2022-05-15' = {
name: '${account.name}/${keyspaceName}'
properties: {
resource: {
id: keyspaceName
}
}
}
resource table 'Microsoft.DocumentDb/databaseAccounts/cassandraKeyspaces/tables@2022-05-15' = {
name: '${keyspace.name}/${tableName}'
properties: {
resource: {
id: tableName
schema: {
columns: [
{
name: 'loadid'
type: 'uuid'
}
{
name: 'machine'
type: 'uuid'
}
{
name: 'cpu'
type: 'int'
}
{
name: 'mtime'
type: 'int'
}
{
name: 'load'
type: 'float'
}
]
partitionKeys: [
{
name: 'machine'
}
{
name: 'cpu'
}
{
name: 'mtime'
}
]
clusterKeys: [
{
name: 'loadid'
orderBy: 'asc'
}
]
}
options: {
throughput: throughput
}
}
}
}
Następne kroki
Oto kilka dodatkowych zasobów: