Udostępnij przez


Baza danych Microsoft.DocumentDBaccounts/cassandraKeyspaces/tables

Definicja zasobu Bicep

Typ zasobu databaseAccounts/cassandraKeyspaces/tables można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/tables, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/tables@2025-11-01-preview' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    options: {
      autoscaleSettings: {
        maxThroughput: int
      }
      throughput: int
    }
    resource: {
      analyticalStorageTtl: int
      defaultTtl: int
      id: 'string'
      schema: {
        clusterKeys: [
          {
            name: 'string'
            orderBy: 'string'
          }
        ]
        columns: [
          {
            name: 'string'
            type: 'string'
          }
        ]
        partitionKeys: [
          {
            name: 'string'
          }
        ]
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Wartości właściwości

Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/tables

Nazwa Opis Wartość
tożsamość Tożsamość zasobu. ManagedServiceIdentity (tożsamość usługi)
lokalizacja Lokalizacja grupy zasobów, do której należy zasób. ciąg
nazwa Nazwa zasobu ciąg (wymagany)
nadrzędny W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.
Nazwa symboliczna zasobu typu: databaseAccounts/cassandraKeyspaces
Właściwości Właściwości do tworzenia i aktualizowania tabeli Cassandra usługi Azure Cosmos DB. CassandraTableCreateUpdatePropertiesOrCassandraTableGetProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

AutoskalowanieUstawienia

Nazwa Opis Wartość
maxThroughput (maksymalna przepływność) Reprezentuje maksymalną przepływność, zasób może być skalowany w górę do. Int

CassandraPartitionKey (Klucz partycji Cassandra)

Nazwa Opis Wartość
nazwa Nazwa klucza partycji tabeli Cassandra usługi Cosmos DB ciąg

Schemat bazy danych CassandraCassandraSchema (Schemat bazy danych

Nazwa Opis Wartość
clusterKeys (klucze klastra) Lista klucza klastra. Klucz klastra[]
Kolumny Lista kolumn tabeli Cassandra. kolumny []
partitionKeys (klucze partycji) Lista klucza partycji. Klucz partycji Cassandra[]

CassandraTableCreateUpdatePropertiesOrCassandraTableGetProperties

Nazwa Opis Wartość
Opcje Para klucz-wartość opcji, które mają zostać zastosowane do żądania. Odpowiada to nagłówkom wysyłanym z żądaniem. CreateUpdateOptionsOrCassandraTableGetPropertiesOptions
zasób Standardowy format JSON tabeli Cassandra CassandraTableResourceOrCassandraTableGetPropertiesResource (wymagane)

CassandraTableResourceOrCassandraTableGetPropertiesResource

Nazwa Opis Wartość
analyticalStorageTtl Analityczny czas wygaśnięcia. Int
defaultTtl (domyślny czas wygaśnięcia) Czas wygaśnięcia tabeli Cassandra usługi Cosmos DB Int
id Nazwa tabeli Cassandra usługi Cosmos DB ciąg (wymagany)
schemat Schemat tabeli Cassandra usługi Cosmos DB Schemat bazy danych CassandraCassandraSchema (Schemat bazy danych

Klucz klastra

Nazwa Opis Wartość
nazwa Nazwa klucza klastra tabel Cassandra usługi Cosmos DB ciąg
sortuj według Kolejność klucza klastra tabel Cassandra usługi Cosmos DB, obsługują tylko polecenia "Asc" i "Desc" ciąg

Kolumna

Nazwa Opis Wartość
nazwa Nazwa kolumny tabeli Cassandra usługi Cosmos DB ciąg
typ Typ kolumny tabeli Cassandra usługi Cosmos DB ciąg

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Nazwa Opis Wartość

CreateUpdateOptionsOrCassandraTableGetPropertiesOptions

Nazwa Opis Wartość
autoskalowanieUstawienia Określa ustawienia autoskalu. Uwaga: wymagana jest przepływność lub autoskalowanieUstawienia, ale nie obie. AutoskalowanieUstawienia
przepływność Liczba jednostek żądania na sekundę. Na przykład "przepływność": 10000. Int

ManagedServiceIdentity

Nazwa Opis Wartość
typ Typ tożsamości używany dla zasobu. Typ "SystemAssigned,UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie wszystkich tożsamości z usługi. "Brak"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned"
tożsamości przypisane użytkownikom Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nazwa Opis Wartość

Tagi

Nazwa Opis Wartość

Przykłady użycia

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Opis
Tworzenie konta usługi Azure Cosmos DB dla interfejsu API Cassandra Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API Cassandra w dwóch regionach z przestrzenią kluczy i tabelą z dedykowaną przepływnością.
Tworzenie automatycznego skalowania konta usługi Azure Cosmos DB dla interfejsu API Cassandra Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API Cassandra w dwóch regionach z przestrzenią kluczy i tabelą z przepływnością autoskalowania.

Definicja zasobu szablonu usługi ARM

Typ zasobu databaseAccounts/cassandraKeyspaces/tables można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/tables, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/tables",
  "apiVersion": "2025-11-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "options": {
      "autoscaleSettings": {
        "maxThroughput": "int"
      },
      "throughput": "int"
    },
    "resource": {
      "analyticalStorageTtl": "int",
      "defaultTtl": "int",
      "id": "string",
      "schema": {
        "clusterKeys": [
          {
            "name": "string",
            "orderBy": "string"
          }
        ],
        "columns": [
          {
            "name": "string",
            "type": "string"
          }
        ],
        "partitionKeys": [
          {
            "name": "string"
          }
        ]
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Wartości właściwości

Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/tables

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API "2025-11-01-podgląd"
tożsamość Tożsamość zasobu. ManagedServiceIdentity (tożsamość usługi)
lokalizacja Lokalizacja grupy zasobów, do której należy zasób. ciąg
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości do tworzenia i aktualizowania tabeli Cassandra usługi Azure Cosmos DB. CassandraTableCreateUpdatePropertiesOrCassandraTableGetProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/tables"

AutoskalowanieUstawienia

Nazwa Opis Wartość
maxThroughput (maksymalna przepływność) Reprezentuje maksymalną przepływność, zasób może być skalowany w górę do. Int

CassandraPartitionKey (Klucz partycji Cassandra)

Nazwa Opis Wartość
nazwa Nazwa klucza partycji tabeli Cassandra usługi Cosmos DB ciąg

Schemat bazy danych CassandraCassandraSchema (Schemat bazy danych

Nazwa Opis Wartość
clusterKeys (klucze klastra) Lista klucza klastra. Klucz klastra[]
Kolumny Lista kolumn tabeli Cassandra. kolumny []
partitionKeys (klucze partycji) Lista klucza partycji. Klucz partycji Cassandra[]

CassandraTableCreateUpdatePropertiesOrCassandraTableGetProperties

Nazwa Opis Wartość
Opcje Para klucz-wartość opcji, które mają zostać zastosowane do żądania. Odpowiada to nagłówkom wysyłanym z żądaniem. CreateUpdateOptionsOrCassandraTableGetPropertiesOptions
zasób Standardowy format JSON tabeli Cassandra CassandraTableResourceOrCassandraTableGetPropertiesResource (wymagane)

CassandraTableResourceOrCassandraTableGetPropertiesResource

Nazwa Opis Wartość
analyticalStorageTtl Analityczny czas wygaśnięcia. Int
defaultTtl (domyślny czas wygaśnięcia) Czas wygaśnięcia tabeli Cassandra usługi Cosmos DB Int
id Nazwa tabeli Cassandra usługi Cosmos DB ciąg (wymagany)
schemat Schemat tabeli Cassandra usługi Cosmos DB Schemat bazy danych CassandraCassandraSchema (Schemat bazy danych

Klucz klastra

Nazwa Opis Wartość
nazwa Nazwa klucza klastra tabel Cassandra usługi Cosmos DB ciąg
sortuj według Kolejność klucza klastra tabel Cassandra usługi Cosmos DB, obsługują tylko polecenia "Asc" i "Desc" ciąg

Kolumna

Nazwa Opis Wartość
nazwa Nazwa kolumny tabeli Cassandra usługi Cosmos DB ciąg
typ Typ kolumny tabeli Cassandra usługi Cosmos DB ciąg

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Nazwa Opis Wartość

CreateUpdateOptionsOrCassandraTableGetPropertiesOptions

Nazwa Opis Wartość
autoskalowanieUstawienia Określa ustawienia autoskalu. Uwaga: wymagana jest przepływność lub autoskalowanieUstawienia, ale nie obie. AutoskalowanieUstawienia
przepływność Liczba jednostek żądania na sekundę. Na przykład "przepływność": 10000. Int

ManagedServiceIdentity

Nazwa Opis Wartość
typ Typ tożsamości używany dla zasobu. Typ "SystemAssigned,UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie wszystkich tożsamości z usługi. "Brak"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned"
tożsamości przypisane użytkownikom Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nazwa Opis Wartość

Tagi

Nazwa Opis Wartość

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon Opis
Tworzenie konta usługi Azure Cosmos DB dla interfejsu API Cassandra

wdrażanie w usłudze Azure
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API Cassandra w dwóch regionach z przestrzenią kluczy i tabelą z dedykowaną przepływnością.
Tworzenie automatycznego skalowania konta usługi Azure Cosmos DB dla interfejsu API Cassandra

wdrażanie w usłudze Azure
Ten szablon tworzy konto usługi Azure Cosmos DB dla interfejsu API Cassandra w dwóch regionach z przestrzenią kluczy i tabelą z przepływnością autoskalowania.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu databaseAccounts/cassandraKeyspaces/tables można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/tables, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/tables@2025-11-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      options = {
        autoscaleSettings = {
          maxThroughput = int
        }
        throughput = int
      }
      resource = {
        analyticalStorageTtl = int
        defaultTtl = int
        id = "string"
        schema = {
          clusterKeys = [
            {
              name = "string"
              orderBy = "string"
            }
          ]
          columns = [
            {
              name = "string"
              type = "string"
            }
          ]
          partitionKeys = [
            {
              name = "string"
            }
          ]
        }
      }
    }
  }
}

Wartości właściwości

Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/tables

Nazwa Opis Wartość
tożsamość Tożsamość zasobu. ManagedServiceIdentity (tożsamość usługi)
lokalizacja Lokalizacja grupy zasobów, do której należy zasób. ciąg
nazwa Nazwa zasobu ciąg (wymagany)
parent_id (identyfikator rodzica) Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: databaseAccounts/cassandraKeyspaces
Właściwości Właściwości do tworzenia i aktualizowania tabeli Cassandra usługi Azure Cosmos DB. CassandraTableCreateUpdatePropertiesOrCassandraTableGetProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/tables@2025-11-01-preview"

AutoskalowanieUstawienia

Nazwa Opis Wartość
maxThroughput (maksymalna przepływność) Reprezentuje maksymalną przepływność, zasób może być skalowany w górę do. Int

CassandraPartitionKey (Klucz partycji Cassandra)

Nazwa Opis Wartość
nazwa Nazwa klucza partycji tabeli Cassandra usługi Cosmos DB ciąg

Schemat bazy danych CassandraCassandraSchema (Schemat bazy danych

Nazwa Opis Wartość
clusterKeys (klucze klastra) Lista klucza klastra. Klucz klastra[]
Kolumny Lista kolumn tabeli Cassandra. kolumny []
partitionKeys (klucze partycji) Lista klucza partycji. Klucz partycji Cassandra[]

CassandraTableCreateUpdatePropertiesOrCassandraTableGetProperties

Nazwa Opis Wartość
Opcje Para klucz-wartość opcji, które mają zostać zastosowane do żądania. Odpowiada to nagłówkom wysyłanym z żądaniem. CreateUpdateOptionsOrCassandraTableGetPropertiesOptions
zasób Standardowy format JSON tabeli Cassandra CassandraTableResourceOrCassandraTableGetPropertiesResource (wymagane)

CassandraTableResourceOrCassandraTableGetPropertiesResource

Nazwa Opis Wartość
analyticalStorageTtl Analityczny czas wygaśnięcia. Int
defaultTtl (domyślny czas wygaśnięcia) Czas wygaśnięcia tabeli Cassandra usługi Cosmos DB Int
id Nazwa tabeli Cassandra usługi Cosmos DB ciąg (wymagany)
schemat Schemat tabeli Cassandra usługi Cosmos DB Schemat bazy danych CassandraCassandraSchema (Schemat bazy danych

Klucz klastra

Nazwa Opis Wartość
nazwa Nazwa klucza klastra tabel Cassandra usługi Cosmos DB ciąg
sortuj według Kolejność klucza klastra tabel Cassandra usługi Cosmos DB, obsługują tylko polecenia "Asc" i "Desc" ciąg

Kolumna

Nazwa Opis Wartość
nazwa Nazwa kolumny tabeli Cassandra usługi Cosmos DB ciąg
typ Typ kolumny tabeli Cassandra usługi Cosmos DB ciąg

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Nazwa Opis Wartość

CreateUpdateOptionsOrCassandraTableGetPropertiesOptions

Nazwa Opis Wartość
autoskalowanieUstawienia Określa ustawienia autoskalu. Uwaga: wymagana jest przepływność lub autoskalowanieUstawienia, ale nie obie. AutoskalowanieUstawienia
przepływność Liczba jednostek żądania na sekundę. Na przykład "przepływność": 10000. Int

ManagedServiceIdentity

Nazwa Opis Wartość
typ Typ tożsamości używany dla zasobu. Typ "SystemAssigned,UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie wszystkich tożsamości z usługi. "Brak"
"SystemAssigned"
"SystemAssigned,UserAssigned"
"UserAssigned"
tożsamości przypisane użytkownikom Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nazwa Opis Wartość

Tagi

Nazwa Opis Wartość

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrażania tabeli Cassandra w przestrzeni kluczy Cassandra usługi Cosmos DB.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
  # This base name will be used to derive all other resource names.
}

variable "location" {
  type    = string
  default = "eastus"
}

locals {
  # Cosmos DB account names must be globally unique, 3-44 chars, lowercase letters or numbers only.
  # Derive names from the base resource_name; users can override via terraform.tfvars to ensure uniqueness.
  account_name  = lower(replace(var.resource_name, "-", ""))
  keyspace_name = "${lower(var.resource_name)}ks"
  table_name    = "${lower(var.resource_name)}tbl"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "databaseAccount" {
  type      = "Microsoft.DocumentDB/databaseAccounts@2024-08-15"
  parent_id = azapi_resource.resourceGroup.id
  name      = local.account_name
  location  = var.location
  body = {
    kind = "GlobalDocumentDB"
    properties = {
      backupPolicy = null
      capabilities = [{
        name = "EnableCassandra"
      }]
      consistencyPolicy = {
        defaultConsistencyLevel = "Strong"
        maxIntervalInSeconds    = 5
        maxStalenessPrefix      = 100
      }
      databaseAccountOfferType           = "Standard"
      defaultIdentity                    = "FirstPartyIdentity"
      disableKeyBasedMetadataWriteAccess = false
      disableLocalAuth                   = false
      enableAnalyticalStorage            = true
      enableAutomaticFailover            = false
      enableBurstCapacity                = false
      enableFreeTier                     = false
      enableMultipleWriteLocations       = false
      enablePartitionMerge               = false
      ipRules                            = []
      isVirtualNetworkFilterEnabled      = false
      locations = [{
        failoverPriority = 0
        isZoneRedundant  = false
        locationName     = var.location
      }]
      minimalTlsVersion           = "Tls12"
      networkAclBypass            = "None"
      networkAclBypassResourceIds = []
      publicNetworkAccess         = "Enabled"
      virtualNetworkRules         = []
    }
  }
}

resource "azapi_resource" "cassandraKeyspace" {
  type      = "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces@2021-10-15"
  parent_id = azapi_resource.databaseAccount.id
  name      = local.keyspace_name
  body = {
    properties = {
      options = {}
      resource = {
        id = local.keyspace_name
      }
    }
  }
}

resource "azapi_resource" "table" {
  type      = "Microsoft.DocumentDB/databaseAccounts/cassandraKeyspaces/tables@2021-10-15"
  parent_id = azapi_resource.cassandraKeyspace.id
  name      = local.table_name
  body = {
    properties = {
      options = {}
      resource = {
        analyticalStorageTtl = 1
        id                   = local.table_name
        schema = {
          clusterKeys = []
          columns = [{
            name = "test1"
            type = "ascii"
            }, {
            name = "test2"
            type = "int"
          }]
          partitionKeys = [{
            name = "test1"
          }]
        }
      }
    }
  }
}