Freigeben über


Microsoft.DocumentDB-DatenbankAccounts/sqlDatabases/container

Bicep-Ressourcendefinition

Der Ressourcentyp "databaseAccounts/sqlDatabases/containers" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers" zu erstellen, fügen Sie Der Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@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
      clientEncryptionPolicy: {
        includedPaths: [
          {
            clientEncryptionKeyId: 'string'
            encryptionAlgorithm: 'string'
            encryptionType: 'string'
            path: 'string'
          }
        ]
        policyFormatVersion: int
      }
      computedProperties: [
        {
          name: 'string'
          query: 'string'
        }
      ]
      conflictResolutionPolicy: {
        conflictResolutionPath: 'string'
        conflictResolutionProcedure: 'string'
        mode: 'string'
      }
      createMode: 'string'
      dataMaskingPolicy: {
        excludedPaths: [
          {
            path: 'string'
          }
        ]
        includedPaths: [
          {
            length: int
            path: 'string'
            startPosition: int
            strategy: 'string'
          }
        ]
        isPolicyEnabled: bool
      }
      defaultTtl: int
      fullTextPolicy: {
        defaultLanguage: 'string'
        fullTextPaths: [
          {
            language: 'string'
            path: 'string'
          }
        ]
      }
      id: 'string'
      indexingPolicy: {
        automatic: bool
        compositeIndexes: [
          [
            {
              order: 'string'
              path: 'string'
            }
          ]
        ]
        excludedPaths: [
          {
            path: 'string'
          }
        ]
        fullTextIndexes: [
          {
            path: 'string'
          }
        ]
        includedPaths: [
          {
            indexes: [
              {
                dataType: 'string'
                kind: 'string'
                precision: int
              }
            ]
            path: 'string'
          }
        ]
        indexingMode: 'string'
        spatialIndexes: [
          {
            path: 'string'
            types: [
              'string'
            ]
          }
        ]
        vectorIndexes: [
          {
            indexingSearchListSize: int
            path: 'string'
            quantizationByteSize: int
            type: 'string'
            vectorIndexShardKey: [
              'string'
            ]
          }
        ]
      }
      materializedViewDefinition: {
        definition: 'string'
        sourceCollectionId: 'string'
        throughputBucketForBuild: int
      }
      materializedViews: [
        {
          id: 'string'
          _rid: 'string'
        }
      ]
      materializedViewsProperties: {
        throughputBucketForBuild: int
      }
      partitionKey: {
        kind: 'string'
        paths: [
          'string'
        ]
        version: int
      }
      restoreParameters: {
        restoreSource: 'string'
        restoreTimestampInUtc: 'string'
        restoreWithTtlDisabled: bool
      }
      uniqueKeyPolicy: {
        uniqueKeys: [
          {
            paths: [
              'string'
            ]
          }
        ]
      }
      vectorEmbeddingPolicy: {
        vectorEmbeddings: [
          {
            dataType: 'string'
            dimensions: int
            distanceFunction: 'string'
            path: 'string'
          }
        ]
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Eigenschaftswerte

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/container

Name Beschreibung Wert
Identität Identität für die Ressource. ManagedServiceIdentity-
Ort Der Speicherort der Ressourcengruppe, zu der die Ressource gehört. Schnur
Name Der Ressourcenname Zeichenfolge (erforderlich)
Elternteil In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource des Typs: databaseAccounts/sqlDatabases
Eigenschaften Eigenschaften zum Erstellen und Aktualisieren des Azure Cosmos DB-Containers. SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen

Einstellungen für die automatische Skalierung

Name Beschreibung Wert
max. Durchsatz Stellt den maximalen Durchsatz dar, auf den die Ressource skaliert werden kann. Int

ClientEncryptionIncludedPath

Name Beschreibung Wert
clientEncryptionKeyId Der Bezeichner des Clientverschlüsselungsschlüssels, der zum Verschlüsseln des Pfads verwendet werden soll. Zeichenfolge (erforderlich)
encryptionAlgorithmus Der Verschlüsselungsalgorithmus, der verwendet wird. Z.B. - AEAD_AES_256_CBC_HMAC_SHA256. Zeichenfolge (erforderlich)
encryptionType (englisch) Der Typ der zu verwendenden Verschlüsselung. Eg - Deterministisch, randomisiert. Zeichenfolge (erforderlich)
Pfad Pfad, der verschlüsselt werden muss. Zeichenfolge (erforderlich)

ClientEncryptionPolicy (ClientEncryptionPolicy)

Name Beschreibung Wert
inkludiertPfade Pfade des Elements, die Verschlüsselung zusammen mit pfadspezifischen Einstellungen benötigen. ClientEncryptionIncludedPath[] (erforderlich)
policyFormatVersion Version der Clientverschlüsselungsrichtliniendefinition. Unterstützte Versionen sind 1 und 2. Version 2 unterstützt die ID- und Partitionsschlüsselpfadverschlüsselung. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 2 (erforderlich)

Komponenten1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Name Beschreibung Wert

Zusammengesetzter Pfad

Name Beschreibung Wert
Bestellung Sortierreihenfolge für zusammengesetzte Pfade. "aufsteigend"
"absteigend"
Pfad Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) Schnur

ComputedProperty

Name Beschreibung Wert
Name Der Name einer berechneten Eigenschaft, z. B. "cp_lowerName" Schnur
Frage Die Abfrage, die den Wert für berechnete Eigenschaft auswertet, z. B. "SELECT VALUE LOWER(c.name) FROM c" Schnur

Richtlinie zur Konfliktlösung

Name Beschreibung Wert
conflictResolutionPath Der Konfliktlösungspfad im Fall des LastWriterWins-Modus. Schnur
conflictResolutionProcedure Die Prozedur zum Beheben von Konflikten im Fall des benutzerdefinierten Modus. Schnur
Modus Gibt den Konfliktauflösungsmodus an. 'Benutzerdefiniert'
"LastWriterWins"

ContainerPartitionKey

Name Beschreibung Wert
Art Gibt die Art des Algorithmus an, der für die Partitionierung verwendet wird. Bei MultiHash werden mehrere Partitionsschlüssel (maximal drei) für die Containererstellung unterstützt. "Hash"
"MultiHash"
"Reichweite"
Pfade Liste der Pfade, die verwenden, welche Daten innerhalb des Containers partitioniert werden können Zeichenfolge[]
Version Gibt die Version der Partitionsschlüsseldefinition an. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 2

CreateUpdateOptionsOrSqlContainerGetPropertiesOptions

Name Beschreibung Wert
autoscaleEinstellungen Gibt die Einstellungen für die Autoskalen an. Hinweis: Entweder Durchsatz oder AutoscaleSettings ist erforderlich, aber nicht beides. AutoscaleSettings-
Durchsatz Anforderungseinheiten pro Sekunde. Beispiel: "Durchsatz": 10000. Int

Datenmaskierungsrichtlinie

Name Beschreibung Wert
ausgeschlossenPfade Liste der JSON-Pfade, die von der Maskierung ausgeschlossen werden sollen. DataMaskingPolicyExcludedPathsItem[]
inkludiertPfade Liste der JSON-Pfade, die in die Maskierungsrichtlinie aufgenommen werden sollen. DataMaskingPolicyIncludedPathsItem[]
isPolicyEnabled Flag, das angibt, ob die Datenmaskierungsrichtlinie aktiviert ist. Bool

DataMaskingPolicyExcludedPathsItem

Name Beschreibung Wert
Pfad Der JSON-Pfad, der von der Maskierung ausgeschlossen werden soll (z. B. "/id"). Zeichenfolge (erforderlich)

DataMaskingPolicyIncludedPathsItem

Name Beschreibung Wert
length Länge der zu maskierenden Teilzeichenfolge (falls zutreffend). Int
Pfad Der JSON-Pfad zum Anwenden der Maskierung (z. B. "/contact/phones"). Zeichenfolge (erforderlich)
StartPosition Startposition für die Maskierung von Teilzeichenfolgen (falls zutreffend). Int
strategy Anzuwendende Maskierungsstrategie (z. B. "MaskSubstring"). Schnur

Ausgeschlossener Pfad

Name Beschreibung Wert
Pfad Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) Schnur

VolltextIndexPfad

Name Beschreibung Wert
Pfad Der Pfad zum Volltextfeld im Dokument. Zeichenfolge (erforderlich)

VolltextPfad

Name Beschreibung Wert
Sprache Die Sprache des Volltextfelds im Dokument. Schnur
Pfad Der Pfad zum Volltextfeld im Dokument. Zeichenfolge (erforderlich)

VolltextRichtlinie

Name Beschreibung Wert
defaultLanguage Die Standardsprache für Volltextpfade. Schnur
fullTextPaths Liste der FullText-Pfade VolltextPfad[]

InkludierterPfad

Name Beschreibung Wert
indexe Liste der Indizes für diesen Pfad Indizes[]
Pfad Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) Schnur

Indexe

Name Beschreibung Wert
Datatype Der Datentyp, auf den das Indizierungsverhalten angewendet wird. 'Zeilenzeichenfolge'
"MultiPolygon"
"Zahl"
"Punkt"
"Polygon"
'Saite'
Art Gibt den Indextyp an. "Hash"
"Reichweite"
"Raum"
Präzision Die Genauigkeit des Indexes. -1 ist maximale Genauigkeit. Int

Indexierungsrichtlinie

Name Beschreibung Wert
Automatisch Gibt an, ob die Indizierungsrichtlinie automatisch ist. Bool
composite-Indizes Liste der zusammengesetzten Pfadliste CompositePath-[][]
ausgeschlossenPfade Liste der Pfade, die von der Indizierung ausgeschlossen werden sollen ExcludedPath-[]
fullTextIndexes Liste der Pfade, die in die Volltextindizierung einbezogen werden sollen VolltextIndexPfad[]
inkludiertPfade Liste der Pfade, die in die Indizierung aufgenommen werden sollen IncludedPath-[]
indexing-Modus Gibt den Indizierungsmodus an. "konsistent"
"faul"
"Keine"
räumliche Indizes Liste der räumlichen Besonderheiten SpatialSpec[]
vectorIndizes Liste der Pfade, die in die Vektorindizierung aufgenommen werden sollen VectorIndex-[]

Verwaltete Dienstidentität

Name Beschreibung Wert
Art Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned,UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Dienst. "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
"UserAssigned"
vom Benutzer zugewiesene Identitäten Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". ManagedServiceIdentityUserAssignedIdentities-

ManagedServiceIdentityUserAssignedIdentities

Name Beschreibung Wert

MaterializedViewDefinition

Name Beschreibung Wert
Definition Die Definition sollte eine SQL-Abfrage sein, die verwendet wird, um Daten aus dem Quellcontainer abzurufen, um in den Materialized View-Container aufzufüllen. Zeichenfolge (erforderlich)
sourceCollectionId Der Name des Quellcontainers, auf dem die Materialisierte Ansicht erstellt wird. Zeichenfolge (erforderlich)
throughputBucketForBuild Durchsatz-Bucket, der für die Vorgänge zur materialisierten Ansicht auf dem Zielcontainer zugewiesen ist. Int

MaterialisiertAnsichtDetails

Name Beschreibung Wert
id ID-Feld des Materialisierten Containers. Schnur
_los _rid Feld des materialisierten Containers. Schnur

MaterializedViewsEigenschaften

Name Beschreibung Wert
throughputBucketForBuild Durchsatz-Bucket, der den materialisierten Ansichtsvorgängen für den Quellcontainer zugewiesen ist. Int

ResourceRestoreParameters

Name Beschreibung Wert
restoreSource Die ID des wiederherstellbaren Datenbankkontos, von dem die Wiederherstellung initiiert werden muss. Beispiel: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} Schnur
restoreTimestampInUtc Zeit, zu der das Konto wiederhergestellt werden muss (ISO-8601-Format). Schnur
restoreWithTtlDisabled Gibt an, ob das wiederhergestellte Konto zeit-To-Live bei der erfolgreichen Wiederherstellung deaktiviert ist. Bool

SpatialSpec

Name Beschreibung Wert
Pfad Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) Schnur
Arten Liste des räumlichen Pfadtyps Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'Zeilenzeichenfolge'
"MultiPolygon"
"Punkt"
"Polygon"

SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties

Name Beschreibung Wert
Optionen Ein Schlüssel-Wert-Optionspaar, das für die Anforderung angewendet werden soll. Dies entspricht den Kopfzeilen, die mit der Anforderung gesendet werden. CreateUpdateOptionsOrSqlContainerGetPropertiesOptions-
Ressource Das standardmäßige JSON-Format eines Containers SqlContainerResourceOrSqlContainerGetPropertiesResource- (erforderlich)

SqlContainerResourceOrSqlContainerGetPropertiesResource

Name Beschreibung Wert
analyticalStorageTtl Analytische tTL. Int
clientEncryptionPolicy (englisch) Die Clientverschlüsselungsrichtlinie für den Container. ClientEncryptionPolicy (ClientEncryptionPolicy)
computedProperties Liste der berechneten Eigenschaften ComputedProperty-[]
conflictResolutionRichtlinie Die Konfliktlösungsrichtlinie für den Container. ConflictResolutionPolicy-
createMode Aufzählung, um den Modus der Ressourcenerstellung anzugeben. 'Standard'
"Wiederherstellen"
dataMasking-Richtlinie Die Datenmaskierungsrichtlinie für den Container. Datenmaskierungsrichtlinie
defaultTtl Standardzeit für Live Int
fullTextPolicy Die FullText-Richtlinie für den Container. VolltextRichtlinie
id Name des Cosmos DB SQL-Containers Zeichenfolge (erforderlich)
indexingRichtlinie Die Konfiguration der Indizierungsrichtlinie. Standardmäßig ist die Indizierung für alle Dokumentpfade innerhalb des Containers automatisch. IndexingPolicy-
materializedViewDefinition Die Konfiguration zum Definieren materialisierter Ansichten. Dies muss nur zum Erstellen eines Materialized View-Containers angegeben werden. MaterializedViewDefinition-
materializedViews Materialisierte Ansichten, die für den Container definiert sind. MaterializedViewDetails[]
materializedViewsEigenschaften Eigenschaften materialisierter Ansichten, die für den Quellcontainer definiert sind. MaterializedViewsEigenschaften
partitionSchlüssel Die Konfiguration des Partitionsschlüssels, der für die Partitionierung von Daten in mehrere Partitionen verwendet werden soll ContainerPartitionKey-
restore-Parameter Parameter, die die Informationen zur Wiederherstellung angeben sollen ResourceRestoreParameters-
uniqueKeyPolicy Die Konfiguration der eindeutigen Schlüsselrichtlinie zum Angeben von Eindeutigkeitseinschränkungen für Dokumente in der Sammlung im Azure Cosmos DB-Dienst. UniqueKeyPolicy-
vectorEmbeddingPolicy Die Vektoreinbettungsrichtlinie für den Container. VectorEmbeddingPolicy-

Schilder

Name Beschreibung Wert

Einzigartiger Schlüssel

Name Beschreibung Wert
Pfade Liste der Pfade muss für jedes Dokument im Azure Cosmos DB-Dienst eindeutig sein. Zeichenfolge[]

UniqueKeyPolicy (UniqueKeyPolicy)

Name Beschreibung Wert
uniqueKeys Liste der eindeutigen Schlüssel für die Erzwingung der Eindeutigkeitseinschränkung für Dokumente in der Sammlung im Azure Cosmos DB-Dienst. UniqueKey-[]

VectorEmbedding

Name Beschreibung Wert
Datatype Gibt den Datentyp des Vektors an. "float16"
"float32"
"int8"
"uint8" (erforderlich)
Dimensionen Die Anzahl der Dimensionen im Vektor. int (erforderlich)
distance-Funktion Die Abstandsfunktion, die für die Entfernungsberechnung zwischen Vektoren verwendet werden soll. "Kosinus"
"dotproduct"
"Euklidan" (erforderlich)
Pfad Der Pfad zum Vektorfeld im Dokument. Zeichenfolge (erforderlich)

VectorEmbedding-Richtlinie

Name Beschreibung Wert
vectorEinbettungen Liste der Vektoreinbettungen VectorEmbedding-[]

VektorIndex

Name Beschreibung Wert
indexingSearchListSize Dies ist die Größe der Kandidatenliste der ungefähren Nachbarn, die beim Erstellen des DiskANN-Index als Teil der Optimierungsprozesse gespeichert werden. Große Werte können den Abruf auf Kosten der Latenz verbessern. Dies gilt nur für den diskANN-Vektorindextyp. Int

Zwänge:
Min.-Wert = 25
Maximalwert = 500
Pfad Der Pfad zum Vektorfeld im Dokument. Zeichenfolge (erforderlich)
quantisierungByteSize Die Anzahl der Bytes, die bei der Produktquantisierung der Vektoren verwendet werden. Ein größerer Wert kann zu einem besseren Abruf bei Vektorsuchen auf Kosten der Latenz führen. Dies gilt nur für die Vektorindextypen quantizedFlat und diskANN. Int

Zwänge:
Min.-Wert = 4
Art Der Indextyp des Vektors. Derzeit werden flat, diskANN und quantizedFlat unterstützt. 'diskANN'
"flach"
'quantizedFlat' (erforderlich)
vectorIndexShardKey Array von Shard-Schlüsseln für den Vektorindex. Dies gilt nur für die Vektorindextypen quantizedFlat und diskANN. Zeichenfolge[]

Verwendungsbeispiele

Azure-Schnellstartbeispiele

Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.

Bicep-Datei Beschreibung
Azure Cosmos DB-Konto-SQL-API mit analytischem Speicher Diese Vorlage erstellt ein Azure Cosmos-Konto für die Core-API (SQL) mit einer Datenbank und einem Container, der mit dem analytischen Speicher konfiguriert ist.
Erstellen eines kostenlosen Azure Cosmos DB-Kontos Diese Vorlage erstellt ein freistufiges Azure Cosmos DB-Konto für die SQL-API mit einer Datenbank mit freigegebenem Durchsatz und Container.
Erstellen eines Azure Cosmos DB-Kontos für die SQL-API- Diese Vorlage erstellt ein Azure Cosmos-Konto für die Core-API (SQL) mit einer Datenbank und einem Container mit Durchsatz mit mehreren anderen Optionen.
Erstellen einer SQL-Konto-API für Azure Cosmos DB mit automatischer Skalierung Diese Vorlage erstellt ein Azure Cosmos-Konto für die Core-API (SQL) mit einer Datenbank und einem Container mit automatischem Durchsatz mit mehreren anderen Optionen.
Erstellen von gespeicherten Prozeduren der Azure Cosmos DB Core -API (SQL) Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Core-API (SQL) und einen Container mit einer gespeicherten Prozedur, triggern und benutzerdefinierten Funktion.
Erstellt eine Dapr Microservices-App mit Container-Apps Erstellen Sie eine Dapr Microservices-App mit Container-Apps.
Erstellt eine Dapr pub-sub servicebus-App mit Container-Apps Erstellen Sie eine Dapr pub-sub servicebus-App mit Container-Apps.
Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung.

ARM-Vorlagenressourcendefinition

Der Ressourcentyp "databaseAccounts/sqlDatabases/containers" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers" zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers",
  "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",
      "clientEncryptionPolicy": {
        "includedPaths": [
          {
            "clientEncryptionKeyId": "string",
            "encryptionAlgorithm": "string",
            "encryptionType": "string",
            "path": "string"
          }
        ],
        "policyFormatVersion": "int"
      },
      "computedProperties": [
        {
          "name": "string",
          "query": "string"
        }
      ],
      "conflictResolutionPolicy": {
        "conflictResolutionPath": "string",
        "conflictResolutionProcedure": "string",
        "mode": "string"
      },
      "createMode": "string",
      "dataMaskingPolicy": {
        "excludedPaths": [
          {
            "path": "string"
          }
        ],
        "includedPaths": [
          {
            "length": "int",
            "path": "string",
            "startPosition": "int",
            "strategy": "string"
          }
        ],
        "isPolicyEnabled": "bool"
      },
      "defaultTtl": "int",
      "fullTextPolicy": {
        "defaultLanguage": "string",
        "fullTextPaths": [
          {
            "language": "string",
            "path": "string"
          }
        ]
      },
      "id": "string",
      "indexingPolicy": {
        "automatic": "bool",
        "compositeIndexes": [
          [
            {
              "order": "string",
              "path": "string"
            }
          ]
        ],
        "excludedPaths": [
          {
            "path": "string"
          }
        ],
        "fullTextIndexes": [
          {
            "path": "string"
          }
        ],
        "includedPaths": [
          {
            "indexes": [
              {
                "dataType": "string",
                "kind": "string",
                "precision": "int"
              }
            ],
            "path": "string"
          }
        ],
        "indexingMode": "string",
        "spatialIndexes": [
          {
            "path": "string",
            "types": [ "string" ]
          }
        ],
        "vectorIndexes": [
          {
            "indexingSearchListSize": "int",
            "path": "string",
            "quantizationByteSize": "int",
            "type": "string",
            "vectorIndexShardKey": [ "string" ]
          }
        ]
      },
      "materializedViewDefinition": {
        "definition": "string",
        "sourceCollectionId": "string",
        "throughputBucketForBuild": "int"
      },
      "materializedViews": [
        {
          "id": "string",
          "_rid": "string"
        }
      ],
      "materializedViewsProperties": {
        "throughputBucketForBuild": "int"
      },
      "partitionKey": {
        "kind": "string",
        "paths": [ "string" ],
        "version": "int"
      },
      "restoreParameters": {
        "restoreSource": "string",
        "restoreTimestampInUtc": "string",
        "restoreWithTtlDisabled": "bool"
      },
      "uniqueKeyPolicy": {
        "uniqueKeys": [
          {
            "paths": [ "string" ]
          }
        ]
      },
      "vectorEmbeddingPolicy": {
        "vectorEmbeddings": [
          {
            "dataType": "string",
            "dimensions": "int",
            "distanceFunction": "string",
            "path": "string"
          }
        ]
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Eigenschaftswerte

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/container

Name Beschreibung Wert
apiVersion (Englisch) Die API-Version '2025-11-01-Vorschau'
Identität Identität für die Ressource. ManagedServiceIdentity-
Ort Der Speicherort der Ressourcengruppe, zu der die Ressource gehört. Schnur
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eigenschaften Eigenschaften zum Erstellen und Aktualisieren des Azure Cosmos DB-Containers. SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen
Art Der Ressourcentyp "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers"

Einstellungen für die automatische Skalierung

Name Beschreibung Wert
max. Durchsatz Stellt den maximalen Durchsatz dar, auf den die Ressource skaliert werden kann. Int

ClientEncryptionIncludedPath

Name Beschreibung Wert
clientEncryptionKeyId Der Bezeichner des Clientverschlüsselungsschlüssels, der zum Verschlüsseln des Pfads verwendet werden soll. Zeichenfolge (erforderlich)
encryptionAlgorithmus Der Verschlüsselungsalgorithmus, der verwendet wird. Z.B. - AEAD_AES_256_CBC_HMAC_SHA256. Zeichenfolge (erforderlich)
encryptionType (englisch) Der Typ der zu verwendenden Verschlüsselung. Eg - Deterministisch, randomisiert. Zeichenfolge (erforderlich)
Pfad Pfad, der verschlüsselt werden muss. Zeichenfolge (erforderlich)

ClientEncryptionPolicy (ClientEncryptionPolicy)

Name Beschreibung Wert
inkludiertPfade Pfade des Elements, die Verschlüsselung zusammen mit pfadspezifischen Einstellungen benötigen. ClientEncryptionIncludedPath[] (erforderlich)
policyFormatVersion Version der Clientverschlüsselungsrichtliniendefinition. Unterstützte Versionen sind 1 und 2. Version 2 unterstützt die ID- und Partitionsschlüsselpfadverschlüsselung. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 2 (erforderlich)

Komponenten1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Name Beschreibung Wert

Zusammengesetzter Pfad

Name Beschreibung Wert
Bestellung Sortierreihenfolge für zusammengesetzte Pfade. "aufsteigend"
"absteigend"
Pfad Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) Schnur

ComputedProperty

Name Beschreibung Wert
Name Der Name einer berechneten Eigenschaft, z. B. "cp_lowerName" Schnur
Frage Die Abfrage, die den Wert für berechnete Eigenschaft auswertet, z. B. "SELECT VALUE LOWER(c.name) FROM c" Schnur

Richtlinie zur Konfliktlösung

Name Beschreibung Wert
conflictResolutionPath Der Konfliktlösungspfad im Fall des LastWriterWins-Modus. Schnur
conflictResolutionProcedure Die Prozedur zum Beheben von Konflikten im Fall des benutzerdefinierten Modus. Schnur
Modus Gibt den Konfliktauflösungsmodus an. 'Benutzerdefiniert'
"LastWriterWins"

ContainerPartitionKey

Name Beschreibung Wert
Art Gibt die Art des Algorithmus an, der für die Partitionierung verwendet wird. Bei MultiHash werden mehrere Partitionsschlüssel (maximal drei) für die Containererstellung unterstützt. "Hash"
"MultiHash"
"Reichweite"
Pfade Liste der Pfade, die verwenden, welche Daten innerhalb des Containers partitioniert werden können Zeichenfolge[]
Version Gibt die Version der Partitionsschlüsseldefinition an. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 2

CreateUpdateOptionsOrSqlContainerGetPropertiesOptions

Name Beschreibung Wert
autoscaleEinstellungen Gibt die Einstellungen für die Autoskalen an. Hinweis: Entweder Durchsatz oder AutoscaleSettings ist erforderlich, aber nicht beides. AutoscaleSettings-
Durchsatz Anforderungseinheiten pro Sekunde. Beispiel: "Durchsatz": 10000. Int

Datenmaskierungsrichtlinie

Name Beschreibung Wert
ausgeschlossenPfade Liste der JSON-Pfade, die von der Maskierung ausgeschlossen werden sollen. DataMaskingPolicyExcludedPathsItem[]
inkludiertPfade Liste der JSON-Pfade, die in die Maskierungsrichtlinie aufgenommen werden sollen. DataMaskingPolicyIncludedPathsItem[]
isPolicyEnabled Flag, das angibt, ob die Datenmaskierungsrichtlinie aktiviert ist. Bool

DataMaskingPolicyExcludedPathsItem

Name Beschreibung Wert
Pfad Der JSON-Pfad, der von der Maskierung ausgeschlossen werden soll (z. B. "/id"). Zeichenfolge (erforderlich)

DataMaskingPolicyIncludedPathsItem

Name Beschreibung Wert
length Länge der zu maskierenden Teilzeichenfolge (falls zutreffend). Int
Pfad Der JSON-Pfad zum Anwenden der Maskierung (z. B. "/contact/phones"). Zeichenfolge (erforderlich)
StartPosition Startposition für die Maskierung von Teilzeichenfolgen (falls zutreffend). Int
strategy Anzuwendende Maskierungsstrategie (z. B. "MaskSubstring"). Schnur

Ausgeschlossener Pfad

Name Beschreibung Wert
Pfad Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) Schnur

VolltextIndexPfad

Name Beschreibung Wert
Pfad Der Pfad zum Volltextfeld im Dokument. Zeichenfolge (erforderlich)

VolltextPfad

Name Beschreibung Wert
Sprache Die Sprache des Volltextfelds im Dokument. Schnur
Pfad Der Pfad zum Volltextfeld im Dokument. Zeichenfolge (erforderlich)

VolltextRichtlinie

Name Beschreibung Wert
defaultLanguage Die Standardsprache für Volltextpfade. Schnur
fullTextPaths Liste der FullText-Pfade VolltextPfad[]

InkludierterPfad

Name Beschreibung Wert
indexe Liste der Indizes für diesen Pfad Indizes[]
Pfad Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) Schnur

Indexe

Name Beschreibung Wert
Datatype Der Datentyp, auf den das Indizierungsverhalten angewendet wird. 'Zeilenzeichenfolge'
"MultiPolygon"
"Zahl"
"Punkt"
"Polygon"
'Saite'
Art Gibt den Indextyp an. "Hash"
"Reichweite"
"Raum"
Präzision Die Genauigkeit des Indexes. -1 ist maximale Genauigkeit. Int

Indexierungsrichtlinie

Name Beschreibung Wert
Automatisch Gibt an, ob die Indizierungsrichtlinie automatisch ist. Bool
composite-Indizes Liste der zusammengesetzten Pfadliste CompositePath-[][]
ausgeschlossenPfade Liste der Pfade, die von der Indizierung ausgeschlossen werden sollen ExcludedPath-[]
fullTextIndexes Liste der Pfade, die in die Volltextindizierung einbezogen werden sollen VolltextIndexPfad[]
inkludiertPfade Liste der Pfade, die in die Indizierung aufgenommen werden sollen IncludedPath-[]
indexing-Modus Gibt den Indizierungsmodus an. "konsistent"
"faul"
"Keine"
räumliche Indizes Liste der räumlichen Besonderheiten SpatialSpec[]
vectorIndizes Liste der Pfade, die in die Vektorindizierung aufgenommen werden sollen VectorIndex-[]

Verwaltete Dienstidentität

Name Beschreibung Wert
Art Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned,UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Dienst. "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
"UserAssigned"
vom Benutzer zugewiesene Identitäten Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". ManagedServiceIdentityUserAssignedIdentities-

ManagedServiceIdentityUserAssignedIdentities

Name Beschreibung Wert

MaterializedViewDefinition

Name Beschreibung Wert
Definition Die Definition sollte eine SQL-Abfrage sein, die verwendet wird, um Daten aus dem Quellcontainer abzurufen, um in den Materialized View-Container aufzufüllen. Zeichenfolge (erforderlich)
sourceCollectionId Der Name des Quellcontainers, auf dem die Materialisierte Ansicht erstellt wird. Zeichenfolge (erforderlich)
throughputBucketForBuild Durchsatz-Bucket, der für die Vorgänge zur materialisierten Ansicht auf dem Zielcontainer zugewiesen ist. Int

MaterialisiertAnsichtDetails

Name Beschreibung Wert
id ID-Feld des Materialisierten Containers. Schnur
_los _rid Feld des materialisierten Containers. Schnur

MaterializedViewsEigenschaften

Name Beschreibung Wert
throughputBucketForBuild Durchsatz-Bucket, der den materialisierten Ansichtsvorgängen für den Quellcontainer zugewiesen ist. Int

ResourceRestoreParameters

Name Beschreibung Wert
restoreSource Die ID des wiederherstellbaren Datenbankkontos, von dem die Wiederherstellung initiiert werden muss. Beispiel: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} Schnur
restoreTimestampInUtc Zeit, zu der das Konto wiederhergestellt werden muss (ISO-8601-Format). Schnur
restoreWithTtlDisabled Gibt an, ob das wiederhergestellte Konto zeit-To-Live bei der erfolgreichen Wiederherstellung deaktiviert ist. Bool

SpatialSpec

Name Beschreibung Wert
Pfad Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) Schnur
Arten Liste des räumlichen Pfadtyps Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'Zeilenzeichenfolge'
"MultiPolygon"
"Punkt"
"Polygon"

SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties

Name Beschreibung Wert
Optionen Ein Schlüssel-Wert-Optionspaar, das für die Anforderung angewendet werden soll. Dies entspricht den Kopfzeilen, die mit der Anforderung gesendet werden. CreateUpdateOptionsOrSqlContainerGetPropertiesOptions-
Ressource Das standardmäßige JSON-Format eines Containers SqlContainerResourceOrSqlContainerGetPropertiesResource- (erforderlich)

SqlContainerResourceOrSqlContainerGetPropertiesResource

Name Beschreibung Wert
analyticalStorageTtl Analytische tTL. Int
clientEncryptionPolicy (englisch) Die Clientverschlüsselungsrichtlinie für den Container. ClientEncryptionPolicy (ClientEncryptionPolicy)
computedProperties Liste der berechneten Eigenschaften ComputedProperty-[]
conflictResolutionRichtlinie Die Konfliktlösungsrichtlinie für den Container. ConflictResolutionPolicy-
createMode Aufzählung, um den Modus der Ressourcenerstellung anzugeben. 'Standard'
"Wiederherstellen"
dataMasking-Richtlinie Die Datenmaskierungsrichtlinie für den Container. Datenmaskierungsrichtlinie
defaultTtl Standardzeit für Live Int
fullTextPolicy Die FullText-Richtlinie für den Container. VolltextRichtlinie
id Name des Cosmos DB SQL-Containers Zeichenfolge (erforderlich)
indexingRichtlinie Die Konfiguration der Indizierungsrichtlinie. Standardmäßig ist die Indizierung für alle Dokumentpfade innerhalb des Containers automatisch. IndexingPolicy-
materializedViewDefinition Die Konfiguration zum Definieren materialisierter Ansichten. Dies muss nur zum Erstellen eines Materialized View-Containers angegeben werden. MaterializedViewDefinition-
materializedViews Materialisierte Ansichten, die für den Container definiert sind. MaterializedViewDetails[]
materializedViewsEigenschaften Eigenschaften materialisierter Ansichten, die für den Quellcontainer definiert sind. MaterializedViewsEigenschaften
partitionSchlüssel Die Konfiguration des Partitionsschlüssels, der für die Partitionierung von Daten in mehrere Partitionen verwendet werden soll ContainerPartitionKey-
restore-Parameter Parameter, die die Informationen zur Wiederherstellung angeben sollen ResourceRestoreParameters-
uniqueKeyPolicy Die Konfiguration der eindeutigen Schlüsselrichtlinie zum Angeben von Eindeutigkeitseinschränkungen für Dokumente in der Sammlung im Azure Cosmos DB-Dienst. UniqueKeyPolicy-
vectorEmbeddingPolicy Die Vektoreinbettungsrichtlinie für den Container. VectorEmbeddingPolicy-

Schilder

Name Beschreibung Wert

Einzigartiger Schlüssel

Name Beschreibung Wert
Pfade Liste der Pfade muss für jedes Dokument im Azure Cosmos DB-Dienst eindeutig sein. Zeichenfolge[]

UniqueKeyPolicy (UniqueKeyPolicy)

Name Beschreibung Wert
uniqueKeys Liste der eindeutigen Schlüssel für die Erzwingung der Eindeutigkeitseinschränkung für Dokumente in der Sammlung im Azure Cosmos DB-Dienst. UniqueKey-[]

VectorEmbedding

Name Beschreibung Wert
Datatype Gibt den Datentyp des Vektors an. "float16"
"float32"
"int8"
"uint8" (erforderlich)
Dimensionen Die Anzahl der Dimensionen im Vektor. int (erforderlich)
distance-Funktion Die Abstandsfunktion, die für die Entfernungsberechnung zwischen Vektoren verwendet werden soll. "Kosinus"
"dotproduct"
"Euklidan" (erforderlich)
Pfad Der Pfad zum Vektorfeld im Dokument. Zeichenfolge (erforderlich)

VectorEmbedding-Richtlinie

Name Beschreibung Wert
vectorEinbettungen Liste der Vektoreinbettungen VectorEmbedding-[]

VektorIndex

Name Beschreibung Wert
indexingSearchListSize Dies ist die Größe der Kandidatenliste der ungefähren Nachbarn, die beim Erstellen des DiskANN-Index als Teil der Optimierungsprozesse gespeichert werden. Große Werte können den Abruf auf Kosten der Latenz verbessern. Dies gilt nur für den diskANN-Vektorindextyp. Int

Zwänge:
Min.-Wert = 25
Maximalwert = 500
Pfad Der Pfad zum Vektorfeld im Dokument. Zeichenfolge (erforderlich)
quantisierungByteSize Die Anzahl der Bytes, die bei der Produktquantisierung der Vektoren verwendet werden. Ein größerer Wert kann zu einem besseren Abruf bei Vektorsuchen auf Kosten der Latenz führen. Dies gilt nur für die Vektorindextypen quantizedFlat und diskANN. Int

Zwänge:
Min.-Wert = 4
Art Der Indextyp des Vektors. Derzeit werden flat, diskANN und quantizedFlat unterstützt. 'diskANN'
"flach"
'quantizedFlat' (erforderlich)
vectorIndexShardKey Array von Shard-Schlüsseln für den Vektorindex. Dies gilt nur für die Vektorindextypen quantizedFlat und diskANN. Zeichenfolge[]

Verwendungsbeispiele

Azure-Schnellstartvorlagen

Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.

Schablone Beschreibung
Azure Cosmos DB-Konto-SQL-API mit analytischem Speicher

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos-Konto für die Core-API (SQL) mit einer Datenbank und einem Container, der mit dem analytischen Speicher konfiguriert ist.
Erstellen eines kostenlosen Azure Cosmos DB-Kontos

Bereitstellen in Azure
Diese Vorlage erstellt ein freistufiges Azure Cosmos DB-Konto für die SQL-API mit einer Datenbank mit freigegebenem Durchsatz und Container.
Erstellen eines Azure Cosmos DB-Kontos für die SQL-API-

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos-Konto für die Core-API (SQL) mit einer Datenbank und einem Container mit Durchsatz mit mehreren anderen Optionen.
Erstellen einer SQL-Konto-API für Azure Cosmos DB mit automatischer Skalierung

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos-Konto für die Core-API (SQL) mit einer Datenbank und einem Container mit automatischem Durchsatz mit mehreren anderen Optionen.
Erstellen von gespeicherten Prozeduren der Azure Cosmos DB Core -API (SQL)

Bereitstellen in Azure
Diese Vorlage erstellt ein Azure Cosmos DB-Konto für die Core-API (SQL) und einen Container mit einer gespeicherten Prozedur, triggern und benutzerdefinierten Funktion.
Erstellt eine Dapr Microservices-App mit Container-Apps

Bereitstellen in Azure
Erstellen Sie eine Dapr Microservices-App mit Container-Apps.
Erstellt eine Dapr pub-sub servicebus-App mit Container-Apps

Bereitstellen in Azure
Erstellen Sie eine Dapr pub-sub servicebus-App mit Container-Apps.
Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung

Bereitstellen in Azure
Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "databaseAccounts/sqlDatabases/containers" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Ressource "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers" zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@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
        clientEncryptionPolicy = {
          includedPaths = [
            {
              clientEncryptionKeyId = "string"
              encryptionAlgorithm = "string"
              encryptionType = "string"
              path = "string"
            }
          ]
          policyFormatVersion = int
        }
        computedProperties = [
          {
            name = "string"
            query = "string"
          }
        ]
        conflictResolutionPolicy = {
          conflictResolutionPath = "string"
          conflictResolutionProcedure = "string"
          mode = "string"
        }
        createMode = "string"
        dataMaskingPolicy = {
          excludedPaths = [
            {
              path = "string"
            }
          ]
          includedPaths = [
            {
              length = int
              path = "string"
              startPosition = int
              strategy = "string"
            }
          ]
          isPolicyEnabled = bool
        }
        defaultTtl = int
        fullTextPolicy = {
          defaultLanguage = "string"
          fullTextPaths = [
            {
              language = "string"
              path = "string"
            }
          ]
        }
        id = "string"
        indexingPolicy = {
          automatic = bool
          compositeIndexes = [
            [
              {
                order = "string"
                path = "string"
              }
            ]
          ]
          excludedPaths = [
            {
              path = "string"
            }
          ]
          fullTextIndexes = [
            {
              path = "string"
            }
          ]
          includedPaths = [
            {
              indexes = [
                {
                  dataType = "string"
                  kind = "string"
                  precision = int
                }
              ]
              path = "string"
            }
          ]
          indexingMode = "string"
          spatialIndexes = [
            {
              path = "string"
              types = [
                "string"
              ]
            }
          ]
          vectorIndexes = [
            {
              indexingSearchListSize = int
              path = "string"
              quantizationByteSize = int
              type = "string"
              vectorIndexShardKey = [
                "string"
              ]
            }
          ]
        }
        materializedViewDefinition = {
          definition = "string"
          sourceCollectionId = "string"
          throughputBucketForBuild = int
        }
        materializedViews = [
          {
            id = "string"
            _rid = "string"
          }
        ]
        materializedViewsProperties = {
          throughputBucketForBuild = int
        }
        partitionKey = {
          kind = "string"
          paths = [
            "string"
          ]
          version = int
        }
        restoreParameters = {
          restoreSource = "string"
          restoreTimestampInUtc = "string"
          restoreWithTtlDisabled = bool
        }
        uniqueKeyPolicy = {
          uniqueKeys = [
            {
              paths = [
                "string"
              ]
            }
          ]
        }
        vectorEmbeddingPolicy = {
          vectorEmbeddings = [
            {
              dataType = "string"
              dimensions = int
              distanceFunction = "string"
              path = "string"
            }
          ]
        }
      }
    }
  }
}

Eigenschaftswerte

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/container

Name Beschreibung Wert
Identität Identität für die Ressource. ManagedServiceIdentity-
Ort Der Speicherort der Ressourcengruppe, zu der die Ressource gehört. Schnur
Name Der Ressourcenname Zeichenfolge (erforderlich)
Eltern-ID Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource des Typs: databaseAccounts/sqlDatabases
Eigenschaften Eigenschaften zum Erstellen und Aktualisieren des Azure Cosmos DB-Containers. SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (erforderlich)
Schilder Ressourcentags Wörterbuch der Tagnamen und -werte.
Art Der Ressourcentyp "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2025-11-01-preview"

Einstellungen für die automatische Skalierung

Name Beschreibung Wert
max. Durchsatz Stellt den maximalen Durchsatz dar, auf den die Ressource skaliert werden kann. Int

ClientEncryptionIncludedPath

Name Beschreibung Wert
clientEncryptionKeyId Der Bezeichner des Clientverschlüsselungsschlüssels, der zum Verschlüsseln des Pfads verwendet werden soll. Zeichenfolge (erforderlich)
encryptionAlgorithmus Der Verschlüsselungsalgorithmus, der verwendet wird. Z.B. - AEAD_AES_256_CBC_HMAC_SHA256. Zeichenfolge (erforderlich)
encryptionType (englisch) Der Typ der zu verwendenden Verschlüsselung. Eg - Deterministisch, randomisiert. Zeichenfolge (erforderlich)
Pfad Pfad, der verschlüsselt werden muss. Zeichenfolge (erforderlich)

ClientEncryptionPolicy (ClientEncryptionPolicy)

Name Beschreibung Wert
inkludiertPfade Pfade des Elements, die Verschlüsselung zusammen mit pfadspezifischen Einstellungen benötigen. ClientEncryptionIncludedPath[] (erforderlich)
policyFormatVersion Version der Clientverschlüsselungsrichtliniendefinition. Unterstützte Versionen sind 1 und 2. Version 2 unterstützt die ID- und Partitionsschlüsselpfadverschlüsselung. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 2 (erforderlich)

Komponenten1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Name Beschreibung Wert

Zusammengesetzter Pfad

Name Beschreibung Wert
Bestellung Sortierreihenfolge für zusammengesetzte Pfade. "aufsteigend"
"absteigend"
Pfad Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) Schnur

ComputedProperty

Name Beschreibung Wert
Name Der Name einer berechneten Eigenschaft, z. B. "cp_lowerName" Schnur
Frage Die Abfrage, die den Wert für berechnete Eigenschaft auswertet, z. B. "SELECT VALUE LOWER(c.name) FROM c" Schnur

Richtlinie zur Konfliktlösung

Name Beschreibung Wert
conflictResolutionPath Der Konfliktlösungspfad im Fall des LastWriterWins-Modus. Schnur
conflictResolutionProcedure Die Prozedur zum Beheben von Konflikten im Fall des benutzerdefinierten Modus. Schnur
Modus Gibt den Konfliktauflösungsmodus an. 'Benutzerdefiniert'
"LastWriterWins"

ContainerPartitionKey

Name Beschreibung Wert
Art Gibt die Art des Algorithmus an, der für die Partitionierung verwendet wird. Bei MultiHash werden mehrere Partitionsschlüssel (maximal drei) für die Containererstellung unterstützt. "Hash"
"MultiHash"
"Reichweite"
Pfade Liste der Pfade, die verwenden, welche Daten innerhalb des Containers partitioniert werden können Zeichenfolge[]
Version Gibt die Version der Partitionsschlüsseldefinition an. Int

Zwänge:
Min.-Wert = 1
Max. Wert = 2

CreateUpdateOptionsOrSqlContainerGetPropertiesOptions

Name Beschreibung Wert
autoscaleEinstellungen Gibt die Einstellungen für die Autoskalen an. Hinweis: Entweder Durchsatz oder AutoscaleSettings ist erforderlich, aber nicht beides. AutoscaleSettings-
Durchsatz Anforderungseinheiten pro Sekunde. Beispiel: "Durchsatz": 10000. Int

Datenmaskierungsrichtlinie

Name Beschreibung Wert
ausgeschlossenPfade Liste der JSON-Pfade, die von der Maskierung ausgeschlossen werden sollen. DataMaskingPolicyExcludedPathsItem[]
inkludiertPfade Liste der JSON-Pfade, die in die Maskierungsrichtlinie aufgenommen werden sollen. DataMaskingPolicyIncludedPathsItem[]
isPolicyEnabled Flag, das angibt, ob die Datenmaskierungsrichtlinie aktiviert ist. Bool

DataMaskingPolicyExcludedPathsItem

Name Beschreibung Wert
Pfad Der JSON-Pfad, der von der Maskierung ausgeschlossen werden soll (z. B. "/id"). Zeichenfolge (erforderlich)

DataMaskingPolicyIncludedPathsItem

Name Beschreibung Wert
length Länge der zu maskierenden Teilzeichenfolge (falls zutreffend). Int
Pfad Der JSON-Pfad zum Anwenden der Maskierung (z. B. "/contact/phones"). Zeichenfolge (erforderlich)
StartPosition Startposition für die Maskierung von Teilzeichenfolgen (falls zutreffend). Int
strategy Anzuwendende Maskierungsstrategie (z. B. "MaskSubstring"). Schnur

Ausgeschlossener Pfad

Name Beschreibung Wert
Pfad Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) Schnur

VolltextIndexPfad

Name Beschreibung Wert
Pfad Der Pfad zum Volltextfeld im Dokument. Zeichenfolge (erforderlich)

VolltextPfad

Name Beschreibung Wert
Sprache Die Sprache des Volltextfelds im Dokument. Schnur
Pfad Der Pfad zum Volltextfeld im Dokument. Zeichenfolge (erforderlich)

VolltextRichtlinie

Name Beschreibung Wert
defaultLanguage Die Standardsprache für Volltextpfade. Schnur
fullTextPaths Liste der FullText-Pfade VolltextPfad[]

InkludierterPfad

Name Beschreibung Wert
indexe Liste der Indizes für diesen Pfad Indizes[]
Pfad Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) Schnur

Indexe

Name Beschreibung Wert
Datatype Der Datentyp, auf den das Indizierungsverhalten angewendet wird. 'Zeilenzeichenfolge'
"MultiPolygon"
"Zahl"
"Punkt"
"Polygon"
'Saite'
Art Gibt den Indextyp an. "Hash"
"Reichweite"
"Raum"
Präzision Die Genauigkeit des Indexes. -1 ist maximale Genauigkeit. Int

Indexierungsrichtlinie

Name Beschreibung Wert
Automatisch Gibt an, ob die Indizierungsrichtlinie automatisch ist. Bool
composite-Indizes Liste der zusammengesetzten Pfadliste CompositePath-[][]
ausgeschlossenPfade Liste der Pfade, die von der Indizierung ausgeschlossen werden sollen ExcludedPath-[]
fullTextIndexes Liste der Pfade, die in die Volltextindizierung einbezogen werden sollen VolltextIndexPfad[]
inkludiertPfade Liste der Pfade, die in die Indizierung aufgenommen werden sollen IncludedPath-[]
indexing-Modus Gibt den Indizierungsmodus an. "konsistent"
"faul"
"Keine"
räumliche Indizes Liste der räumlichen Besonderheiten SpatialSpec[]
vectorIndizes Liste der Pfade, die in die Vektorindizierung aufgenommen werden sollen VectorIndex-[]

Verwaltete Dienstidentität

Name Beschreibung Wert
Art Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned,UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten aus dem Dienst. "Keine"
'SystemZugewiesen'
"SystemAssigned,UserAssigned"
"UserAssigned"
vom Benutzer zugewiesene Identitäten Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". ManagedServiceIdentityUserAssignedIdentities-

ManagedServiceIdentityUserAssignedIdentities

Name Beschreibung Wert

MaterializedViewDefinition

Name Beschreibung Wert
Definition Die Definition sollte eine SQL-Abfrage sein, die verwendet wird, um Daten aus dem Quellcontainer abzurufen, um in den Materialized View-Container aufzufüllen. Zeichenfolge (erforderlich)
sourceCollectionId Der Name des Quellcontainers, auf dem die Materialisierte Ansicht erstellt wird. Zeichenfolge (erforderlich)
throughputBucketForBuild Durchsatz-Bucket, der für die Vorgänge zur materialisierten Ansicht auf dem Zielcontainer zugewiesen ist. Int

MaterialisiertAnsichtDetails

Name Beschreibung Wert
id ID-Feld des Materialisierten Containers. Schnur
_los _rid Feld des materialisierten Containers. Schnur

MaterializedViewsEigenschaften

Name Beschreibung Wert
throughputBucketForBuild Durchsatz-Bucket, der den materialisierten Ansichtsvorgängen für den Quellcontainer zugewiesen ist. Int

ResourceRestoreParameters

Name Beschreibung Wert
restoreSource Die ID des wiederherstellbaren Datenbankkontos, von dem die Wiederherstellung initiiert werden muss. Beispiel: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} Schnur
restoreTimestampInUtc Zeit, zu der das Konto wiederhergestellt werden muss (ISO-8601-Format). Schnur
restoreWithTtlDisabled Gibt an, ob das wiederhergestellte Konto zeit-To-Live bei der erfolgreichen Wiederherstellung deaktiviert ist. Bool

SpatialSpec

Name Beschreibung Wert
Pfad Der Pfad, für den das Indizierungsverhalten gilt. Indexpfade beginnen in der Regel mit stamm und enden mit Einem Wildcard (/pfad/*) Schnur
Arten Liste des räumlichen Pfadtyps Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'Zeilenzeichenfolge'
"MultiPolygon"
"Punkt"
"Polygon"

SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties

Name Beschreibung Wert
Optionen Ein Schlüssel-Wert-Optionspaar, das für die Anforderung angewendet werden soll. Dies entspricht den Kopfzeilen, die mit der Anforderung gesendet werden. CreateUpdateOptionsOrSqlContainerGetPropertiesOptions-
Ressource Das standardmäßige JSON-Format eines Containers SqlContainerResourceOrSqlContainerGetPropertiesResource- (erforderlich)

SqlContainerResourceOrSqlContainerGetPropertiesResource

Name Beschreibung Wert
analyticalStorageTtl Analytische tTL. Int
clientEncryptionPolicy (englisch) Die Clientverschlüsselungsrichtlinie für den Container. ClientEncryptionPolicy (ClientEncryptionPolicy)
computedProperties Liste der berechneten Eigenschaften ComputedProperty-[]
conflictResolutionRichtlinie Die Konfliktlösungsrichtlinie für den Container. ConflictResolutionPolicy-
createMode Aufzählung, um den Modus der Ressourcenerstellung anzugeben. 'Standard'
"Wiederherstellen"
dataMasking-Richtlinie Die Datenmaskierungsrichtlinie für den Container. Datenmaskierungsrichtlinie
defaultTtl Standardzeit für Live Int
fullTextPolicy Die FullText-Richtlinie für den Container. VolltextRichtlinie
id Name des Cosmos DB SQL-Containers Zeichenfolge (erforderlich)
indexingRichtlinie Die Konfiguration der Indizierungsrichtlinie. Standardmäßig ist die Indizierung für alle Dokumentpfade innerhalb des Containers automatisch. IndexingPolicy-
materializedViewDefinition Die Konfiguration zum Definieren materialisierter Ansichten. Dies muss nur zum Erstellen eines Materialized View-Containers angegeben werden. MaterializedViewDefinition-
materializedViews Materialisierte Ansichten, die für den Container definiert sind. MaterializedViewDetails[]
materializedViewsEigenschaften Eigenschaften materialisierter Ansichten, die für den Quellcontainer definiert sind. MaterializedViewsEigenschaften
partitionSchlüssel Die Konfiguration des Partitionsschlüssels, der für die Partitionierung von Daten in mehrere Partitionen verwendet werden soll ContainerPartitionKey-
restore-Parameter Parameter, die die Informationen zur Wiederherstellung angeben sollen ResourceRestoreParameters-
uniqueKeyPolicy Die Konfiguration der eindeutigen Schlüsselrichtlinie zum Angeben von Eindeutigkeitseinschränkungen für Dokumente in der Sammlung im Azure Cosmos DB-Dienst. UniqueKeyPolicy-
vectorEmbeddingPolicy Die Vektoreinbettungsrichtlinie für den Container. VectorEmbeddingPolicy-

Schilder

Name Beschreibung Wert

Einzigartiger Schlüssel

Name Beschreibung Wert
Pfade Liste der Pfade muss für jedes Dokument im Azure Cosmos DB-Dienst eindeutig sein. Zeichenfolge[]

UniqueKeyPolicy (UniqueKeyPolicy)

Name Beschreibung Wert
uniqueKeys Liste der eindeutigen Schlüssel für die Erzwingung der Eindeutigkeitseinschränkung für Dokumente in der Sammlung im Azure Cosmos DB-Dienst. UniqueKey-[]

VectorEmbedding

Name Beschreibung Wert
Datatype Gibt den Datentyp des Vektors an. "float16"
"float32"
"int8"
"uint8" (erforderlich)
Dimensionen Die Anzahl der Dimensionen im Vektor. int (erforderlich)
distance-Funktion Die Abstandsfunktion, die für die Entfernungsberechnung zwischen Vektoren verwendet werden soll. "Kosinus"
"dotproduct"
"Euklidan" (erforderlich)
Pfad Der Pfad zum Vektorfeld im Dokument. Zeichenfolge (erforderlich)

VectorEmbedding-Richtlinie

Name Beschreibung Wert
vectorEinbettungen Liste der Vektoreinbettungen VectorEmbedding-[]

VektorIndex

Name Beschreibung Wert
indexingSearchListSize Dies ist die Größe der Kandidatenliste der ungefähren Nachbarn, die beim Erstellen des DiskANN-Index als Teil der Optimierungsprozesse gespeichert werden. Große Werte können den Abruf auf Kosten der Latenz verbessern. Dies gilt nur für den diskANN-Vektorindextyp. Int

Zwänge:
Min.-Wert = 25
Maximalwert = 500
Pfad Der Pfad zum Vektorfeld im Dokument. Zeichenfolge (erforderlich)
quantisierungByteSize Die Anzahl der Bytes, die bei der Produktquantisierung der Vektoren verwendet werden. Ein größerer Wert kann zu einem besseren Abruf bei Vektorsuchen auf Kosten der Latenz führen. Dies gilt nur für die Vektorindextypen quantizedFlat und diskANN. Int

Zwänge:
Min.-Wert = 4
Art Der Indextyp des Vektors. Derzeit werden flat, diskANN und quantizedFlat unterstützt. 'diskANN'
"flach"
'quantizedFlat' (erforderlich)
vectorIndexShardKey Array von Shard-Schlüsseln für den Vektorindex. Dies gilt nur für die Vektorindextypen quantizedFlat und diskANN. Zeichenfolge[]

Verwendungsbeispiele

Terraform-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung von SQL-Containern in einem Cosmos DB-Konto.

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

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

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

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@2021-10-15"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "GlobalDocumentDB"
    properties = {
      capabilities = [
      ]
      consistencyPolicy = {
        defaultConsistencyLevel = "BoundedStaleness"
        maxIntervalInSeconds    = 10
        maxStalenessPrefix      = 200
      }
      databaseAccountOfferType           = "Standard"
      defaultIdentity                    = "FirstPartyIdentity"
      disableKeyBasedMetadataWriteAccess = false
      disableLocalAuth                   = false
      enableAnalyticalStorage            = false
      enableAutomaticFailover            = false
      enableFreeTier                     = false
      enableMultipleWriteLocations       = false
      ipRules = [
      ]
      isVirtualNetworkFilterEnabled = false
      locations = [
        {
          failoverPriority = 0
          isZoneRedundant  = false
          locationName     = "West Europe"
        },
      ]
      networkAclBypass = "None"
      networkAclBypassResourceIds = [
      ]
      publicNetworkAccess = "Enabled"
      virtualNetworkRules = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "sqlDatabase" {
  type      = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2021-10-15"
  parent_id = azapi_resource.databaseAccount.id
  name      = var.resource_name
  body = {
    properties = {
      options = {
        throughput = 400
      }
      resource = {
        id = var.resource_name
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "container" {
  type      = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2023-04-15"
  parent_id = azapi_resource.sqlDatabase.id
  name      = var.resource_name
  body = {
    properties = {
      options = {
      }
      resource = {
        id = "test-containerWest Europe"
        partitionKey = {
          kind = "Hash"
          paths = [
            "/definition",
          ]
        }
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}