Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
- neueste
- 01.11.2025 Vorschau
- 2025-10-15
- 2025-05-01-Vorschau
- 2025-04-15
- 2024-12-01-Preview-
- 2024-11-15
- 2024-09-01-Preview-
- 2024-08-15
- 2024-05-15
- 2024-05-15-Vorschau-
- 2024-02-15-Preview-
- 2023-11-15
- 2023-11-15-Vorschau-
- 2023-09-15
- 2023-09-15-Preview-
- 2023-04-15
- 2023-03-15
- 2023-03-15-Vorschau-
- 2023-03-01-Preview-
- 2022-11-15
- 2022-11-15-Vorschau-
- 2022-08-15
- 2022-08-15-Vorschau-
- 2022-05-15
- 2022-05-15-Preview-
- 2022-02-15-Preview-
- 2021-11-15-Preview-
- 2021-10-15
- 2021-10-15-Preview-
- 2021-07-01-Preview-
- 2021-06-15
- 2021-05-15
- 2021-04-15
- 2021-04-01-Preview
- 2021-03-15
- 2021-03-01-Preview-
- 15.01.2021
- 2020-09-01
- 2020-06-01-Preview-
- 2020-04-01
- 2020-03-01
- 2019-12-12
- 2019-08-01
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 |
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. |
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 = ["*"]
}