Condividi tramite

Database Microsoft.DocumentDBAccounts/sqlDatabases/containers 2023-03-15-preview

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa databaseAccounts/sqlDatabases/containers può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2023-03-15-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
      }
      conflictResolutionPolicy: {
        conflictResolutionPath: 'string'
        conflictResolutionProcedure: 'string'
        mode: 'string'
      }
      createMode: 'string'
      defaultTtl: int
      id: 'string'
      indexingPolicy: {
        automatic: bool
        compositeIndexes: [
          [
            {
              order: 'string'
              path: 'string'
            }
          ]
        ]
        excludedPaths: [
          {
            path: 'string'
          }
        ]
        includedPaths: [
          {
            indexes: [
              {
                dataType: 'string'
                kind: 'string'
                precision: int
              }
            ]
            path: 'string'
          }
        ]
        indexingMode: 'string'
        spatialIndexes: [
          {
            path: 'string'
            types: [
              'string'
            ]
          }
        ]
      }
      materializedViewDefinition: {
        definition: 'string'
        sourceCollectionId: 'string'
      }
      partitionKey: {
        kind: 'string'
        paths: [
          'string'
        ]
        version: int
      }
      restoreParameters: {
        restoreSource: 'string'
        restoreTimestampInUtc: 'string'
      }
      uniqueKeyPolicy: {
        uniqueKeys: [
          {
            paths: [
              'string'
            ]
          }
        ]
      }
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

Impostazioni di scalabilità automatica

Nome Descrizione Valore
maxThroughput Rappresenta la velocità effettiva massima, la risorsa può aumentare le prestazioni. Int

ClientEncryptionIncludedPath

Nome Descrizione Valore
clientEncryptionKeyId Identificatore della chiave di crittografia client da usare per crittografare il percorso. stringa (obbligatorio)
encryptionAlgorithm Algoritmo di crittografia che verrà usato. Ad esempio, AEAD_AES_256_CBC_HMAC_SHA256. stringa (obbligatorio)
encryptionType Tipo di crittografia da eseguire. Ad esempio: deterministico, casuale. stringa (obbligatorio)
sentiero Percorso che deve essere crittografato. stringa (obbligatorio)

ClientEncryptionPolicy

Nome Descrizione Valore
includedPaths Percorsi dell'elemento che richiedono la crittografia insieme alle impostazioni specifiche del percorso. ClientEncryptionIncludedPath[] (obbligatorio)
policyFormatVersion Versione della definizione dei criteri di crittografia client. Le versioni supportate sono 1 e 2. La versione 2 supporta la crittografia id e percorso della chiave di partizione. Int

Vincoli:
Valore minimo = 1
Valore massimo = 2 (obbligatorio)

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome Descrizione Valore

CompositePath

Nome Descrizione Valore
ordine Ordinamento per i percorsi compositi. 'crescente'
'decrescente'
sentiero Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) corda

ConflictResolutionPolicy

Nome Descrizione Valore
conflictResolutionPath Percorso di risoluzione dei conflitti nel caso della modalità LastWriterWins. corda
conflictResolutionProcedure Procedura per risolvere i conflitti in caso di modalità personalizzata. corda
modo Indica la modalità di risoluzione dei conflitti. 'Custom'
'LastWriterWins'

ContainerPartitionKey

Nome Descrizione Valore
gentile Indica il tipo di algoritmo utilizzato per il partizionamento. Per MultiHash sono supportate più chiavi di partizione (fino a tre massime) per la creazione di contenitori 'Hash'
'MultiHash'
'Range'
Percorsi Elenco di percorsi che usano i dati all'interno del contenitore che possono essere partizionati string[]
Versione Indica la versione della definizione della chiave di partizione Int

Vincoli:
Valore minimo = 1
Valore massimo = 2

CreateUpdateOptionsOrSqlContainerGetPropertiesOptions

Nome Descrizione Valore
autoscaleSettings Specifica le impostazioni di scalabilità automatica. impostazione di scalabilità automaticaImpostazioni di scalabilità automatica
Velocità effettiva Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000. Int

ExcludedPath

Nome Descrizione Valore
sentiero Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) corda

IncludedPath

Nome Descrizione Valore
Indici Elenco di indici per questo percorso indici[]
sentiero Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) corda

Indici

Nome Descrizione Valore
Datatype Tipo di dati a cui viene applicato il comportamento di indicizzazione. 'LineString'
'MultiPolygon'
'Number'
'Point'
'Poligono'
'String'
gentile Indica il tipo di indice. 'Hash'
'Range'
'Spaziale'
precisione Precisione dell'indice. -1 è la precisione massima. Int

IndexingPolicy

Nome Descrizione Valore
Automatico Indica se i criteri di indicizzazione sono automatici Bool
compositeIndexes Elenco di elenco di percorsi compositi CompositePath [][]
excludedPaths Elenco di percorsi da escludere dall'indicizzazione ExcludedPath []
includedPaths Elenco di percorsi da includere nell'indicizzazione IncludedPath []
indexingMode Indica la modalità di indicizzazione. 'coerente'
'lazy'
'none'
spatialIndexes Elenco di specifiche spaziali SpatialSpec []

ManagedServiceIdentity

Nome Descrizione Valore
digitare Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned,UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal servizio. 'Nessuno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Descrizione Valore

MaterializedViewDefinition

Nome Descrizione Valore
definizione La definizione deve essere una query SQL che verrebbe usata per recuperare i dati dal contenitore di origine per popolare nel contenitore Vista materializzata. stringa (obbligatorio)
sourceCollectionId Nome del contenitore di origine in cui verrà creata la vista materializzata. stringa (obbligatorio)

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers

Nome Descrizione Valore
identità Identità per la risorsa. ManagedServiceIdentity
ubicazione Posizione del gruppo di risorse a cui appartiene la risorsa. corda
nome Nome della risorsa stringa (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.		 Nome simbolico per la risorsa di tipo: databaseAccounts/sqlDatabases
proprietà Proprietà per creare e aggiornare il contenitore Azure Cosmos DB. SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

ResourceRestoreParameters

Nome Descrizione Valore
restoreSource ID dell'account di database ripristinabile da cui deve essere avviato il ripristino. Ad esempio: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} corda
restoreTimestampInUtc Ora di ripristino dell'account (formato ISO-8601). corda

SpatialSpec

Nome Descrizione Valore
sentiero Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) corda
Tipi Elenco del tipo spaziale del percorso Matrice di stringhe contenente uno dei seguenti elementi:
'LineString'
'MultiPolygon'
'Point'
'Poligono'

SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties

Nome Descrizione Valore
Opzioni Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta. CreateUpdateOptionsOrSqlContainerGetPropertiesOptions
risorsa Formato JSON standard di un contenitore SqlContainerResourceOrSqlContainerGetPropertiesResource (obbligatorio)

SqlContainerResourceOrSqlContainerGetPropertiesResource

Nome Descrizione Valore
analyticalStorageTtl TTL analitico. Int
clientEncryptionPolicy Criteri di crittografia client per il contenitore. ClientEncryptionPolicy
conflictResolutionPolicy Criteri di risoluzione dei conflitti per il contenitore. ConflictResolutionPolicy
createMode Enumerazione per indicare la modalità di creazione della risorsa. 'Default'
'PointInTimeRestore'
'Restore'
defaultTtl Durata predefinita Int
Id Nome del contenitore SQL di Cosmos DB stringa (obbligatorio)
indexingPolicy Configurazione dei criteri di indicizzazione. Per impostazione predefinita, l'indicizzazione è automatica per tutti i percorsi dei documenti all'interno del contenitore IndexingPolicy
materializedViewDefinition Configurazione per la definizione di viste materializzate. Questa operazione deve essere specificata solo per la creazione di un contenitore vista materializzata. MaterializedViewDefinition
partitionKey Configurazione della chiave di partizione da usare per il partizionamento dei dati in più partizioni ContainerPartitionKey
restoreParameters Parametri per indicare le informazioni sul ripristino ResourceRestoreParameters
uniqueKeyPolicy Configurazione dei criteri chiave univoca per specificare vincoli di univocità per i documenti nella raccolta nel servizio Azure Cosmos DB. UniqueKeyPolicy

Tag

Nome Descrizione Valore

UniqueKey

Nome Descrizione Valore
Percorsi L'elenco dei percorsi deve essere univoco per ogni documento nel servizio Azure Cosmos DB string[]

UniqueKeyPolicy

Nome Descrizione Valore
uniqueKeys Elenco di chiavi univoche in che applicano vincoli di univocità per i documenti nella raccolta nel servizio Azure Cosmos DB. UniqueKey []

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File Descrizione
'API SQL dell'account Azure Cosmos DB con l'archivio analitico Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore configurati con l'archivio analitico.
Creare un account Azure Cosmos DB di livello gratuito Questo modello crea un account Azure Cosmos DB di livello gratuito per l'API SQL con un database con velocità effettiva e contenitore condivisi.
Creare un account Azure Cosmos DB per l'API Core (SQL) Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore con velocità effettiva con più altre opzioni.
Creare un'API SQL dell'account Azure Cosmos DB con scalabilità automatica Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore con velocità effettiva con scalabilità automatica con più altre opzioni.
Creare stored procedure dell'API Core (SQL) di Azure Cosmos DB Questo modello crea un account Azure Cosmos DB per l'API Core (SQL) e un contenitore con una stored procedure, un trigger e una funzione definita dall'utente.
Crea un'app di microservizi Dapr usando app contenitore Creare un'app di microservizi Dapr usando App contenitore.
Crea un'app pub-sub-servicebus dapr usando app contenitore Creare un'app pub-sub servicebus dapr usando App contenitore.
Distribuire Azure Data Explorer DB con la connessione di Cosmos DB Distribuire Azure Data Explorer DB con la connessione Cosmos DB.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa databaseAccounts/sqlDatabases/containers può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers",
  "apiVersion": "2023-03-15-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"
      },
      "conflictResolutionPolicy": {
        "conflictResolutionPath": "string",
        "conflictResolutionProcedure": "string",
        "mode": "string"
      },
      "createMode": "string",
      "defaultTtl": "int",
      "id": "string",
      "indexingPolicy": {
        "automatic": "bool",
        "compositeIndexes": [
          [
            {
              "order": "string",
              "path": "string"
            }
          ]
        ],
        "excludedPaths": [
          {
            "path": "string"
          }
        ],
        "includedPaths": [
          {
            "indexes": [
              {
                "dataType": "string",
                "kind": "string",
                "precision": "int"
              }
            ],
            "path": "string"
          }
        ],
        "indexingMode": "string",
        "spatialIndexes": [
          {
            "path": "string",
            "types": [ "string" ]
          }
        ]
      },
      "materializedViewDefinition": {
        "definition": "string",
        "sourceCollectionId": "string"
      },
      "partitionKey": {
        "kind": "string",
        "paths": [ "string" ],
        "version": "int"
      },
      "restoreParameters": {
        "restoreSource": "string",
        "restoreTimestampInUtc": "string"
      },
      "uniqueKeyPolicy": {
        "uniqueKeys": [
          {
            "paths": [ "string" ]
          }
        ]
      }
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

Impostazioni di scalabilità automatica

Nome Descrizione Valore
maxThroughput Rappresenta la velocità effettiva massima, la risorsa può aumentare le prestazioni. Int

ClientEncryptionIncludedPath

Nome Descrizione Valore
clientEncryptionKeyId Identificatore della chiave di crittografia client da usare per crittografare il percorso. stringa (obbligatorio)
encryptionAlgorithm Algoritmo di crittografia che verrà usato. Ad esempio, AEAD_AES_256_CBC_HMAC_SHA256. stringa (obbligatorio)
encryptionType Tipo di crittografia da eseguire. Ad esempio: deterministico, casuale. stringa (obbligatorio)
sentiero Percorso che deve essere crittografato. stringa (obbligatorio)

ClientEncryptionPolicy

Nome Descrizione Valore
includedPaths Percorsi dell'elemento che richiedono la crittografia insieme alle impostazioni specifiche del percorso. ClientEncryptionIncludedPath[] (obbligatorio)
policyFormatVersion Versione della definizione dei criteri di crittografia client. Le versioni supportate sono 1 e 2. La versione 2 supporta la crittografia id e percorso della chiave di partizione. Int

Vincoli:
Valore minimo = 1
Valore massimo = 2 (obbligatorio)

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome Descrizione Valore

CompositePath

Nome Descrizione Valore
ordine Ordinamento per i percorsi compositi. 'crescente'
'decrescente'
sentiero Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) corda

ConflictResolutionPolicy

Nome Descrizione Valore
conflictResolutionPath Percorso di risoluzione dei conflitti nel caso della modalità LastWriterWins. corda
conflictResolutionProcedure Procedura per risolvere i conflitti in caso di modalità personalizzata. corda
modo Indica la modalità di risoluzione dei conflitti. 'Custom'
'LastWriterWins'

ContainerPartitionKey

Nome Descrizione Valore
gentile Indica il tipo di algoritmo utilizzato per il partizionamento. Per MultiHash sono supportate più chiavi di partizione (fino a tre massime) per la creazione di contenitori 'Hash'
'MultiHash'
'Range'
Percorsi Elenco di percorsi che usano i dati all'interno del contenitore che possono essere partizionati string[]
Versione Indica la versione della definizione della chiave di partizione Int

Vincoli:
Valore minimo = 1
Valore massimo = 2

CreateUpdateOptionsOrSqlContainerGetPropertiesOptions

Nome Descrizione Valore
autoscaleSettings Specifica le impostazioni di scalabilità automatica. impostazione di scalabilità automaticaImpostazioni di scalabilità automatica
Velocità effettiva Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000. Int

ExcludedPath

Nome Descrizione Valore
sentiero Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) corda

IncludedPath

Nome Descrizione Valore
Indici Elenco di indici per questo percorso indici[]
sentiero Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) corda

Indici

Nome Descrizione Valore
Datatype Tipo di dati a cui viene applicato il comportamento di indicizzazione. 'LineString'
'MultiPolygon'
'Number'
'Point'
'Poligono'
'String'
gentile Indica il tipo di indice. 'Hash'
'Range'
'Spaziale'
precisione Precisione dell'indice. -1 è la precisione massima. Int

IndexingPolicy

Nome Descrizione Valore
Automatico Indica se i criteri di indicizzazione sono automatici Bool
compositeIndexes Elenco di elenco di percorsi compositi CompositePath [][]
excludedPaths Elenco di percorsi da escludere dall'indicizzazione ExcludedPath []
includedPaths Elenco di percorsi da includere nell'indicizzazione IncludedPath []
indexingMode Indica la modalità di indicizzazione. 'coerente'
'lazy'
'none'
spatialIndexes Elenco di specifiche spaziali SpatialSpec []

ManagedServiceIdentity

Nome Descrizione Valore
digitare Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned,UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal servizio. 'Nessuno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Descrizione Valore

MaterializedViewDefinition

Nome Descrizione Valore
definizione La definizione deve essere una query SQL che verrebbe usata per recuperare i dati dal contenitore di origine per popolare nel contenitore Vista materializzata. stringa (obbligatorio)
sourceCollectionId Nome del contenitore di origine in cui verrà creata la vista materializzata. stringa (obbligatorio)

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers

Nome Descrizione Valore
apiVersion Versione dell'API '2023-03-15-preview'
identità Identità per la risorsa. ManagedServiceIdentity
ubicazione Posizione del gruppo di risorse a cui appartiene la risorsa. corda
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà per creare e aggiornare il contenitore Azure Cosmos DB. SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers'

ResourceRestoreParameters

Nome Descrizione Valore
restoreSource ID dell'account di database ripristinabile da cui deve essere avviato il ripristino. Ad esempio: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} corda
restoreTimestampInUtc Ora di ripristino dell'account (formato ISO-8601). corda

SpatialSpec

Nome Descrizione Valore
sentiero Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) corda
Tipi Elenco del tipo spaziale del percorso Matrice di stringhe contenente uno dei seguenti elementi:
'LineString'
'MultiPolygon'
'Point'
'Poligono'

SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties

Nome Descrizione Valore
Opzioni Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta. CreateUpdateOptionsOrSqlContainerGetPropertiesOptions
risorsa Formato JSON standard di un contenitore SqlContainerResourceOrSqlContainerGetPropertiesResource (obbligatorio)

SqlContainerResourceOrSqlContainerGetPropertiesResource

Nome Descrizione Valore
analyticalStorageTtl TTL analitico. Int
clientEncryptionPolicy Criteri di crittografia client per il contenitore. ClientEncryptionPolicy
conflictResolutionPolicy Criteri di risoluzione dei conflitti per il contenitore. ConflictResolutionPolicy
createMode Enumerazione per indicare la modalità di creazione della risorsa. 'Default'
'PointInTimeRestore'
'Restore'
defaultTtl Durata predefinita Int
Id Nome del contenitore SQL di Cosmos DB stringa (obbligatorio)
indexingPolicy Configurazione dei criteri di indicizzazione. Per impostazione predefinita, l'indicizzazione è automatica per tutti i percorsi dei documenti all'interno del contenitore IndexingPolicy
materializedViewDefinition Configurazione per la definizione di viste materializzate. Questa operazione deve essere specificata solo per la creazione di un contenitore vista materializzata. MaterializedViewDefinition
partitionKey Configurazione della chiave di partizione da usare per il partizionamento dei dati in più partizioni ContainerPartitionKey
restoreParameters Parametri per indicare le informazioni sul ripristino ResourceRestoreParameters
uniqueKeyPolicy Configurazione dei criteri chiave univoca per specificare vincoli di univocità per i documenti nella raccolta nel servizio Azure Cosmos DB. UniqueKeyPolicy

Tag

Nome Descrizione Valore

UniqueKey

Nome Descrizione Valore
Percorsi L'elenco dei percorsi deve essere univoco per ogni documento nel servizio Azure Cosmos DB string[]

UniqueKeyPolicy

Nome Descrizione Valore
uniqueKeys Elenco di chiavi univoche in che applicano vincoli di univocità per i documenti nella raccolta nel servizio Azure Cosmos DB. UniqueKey []

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Sagoma Descrizione
'API SQL dell'account Azure Cosmos DB con l'archivio analitico

Distribuire in Azure 		Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore configurati con l'archivio analitico.
Creare un account Azure Cosmos DB di livello gratuito

Distribuire in Azure 		Questo modello crea un account Azure Cosmos DB di livello gratuito per l'API SQL con un database con velocità effettiva e contenitore condivisi.
Creare un account Azure Cosmos DB per l'API Core (SQL)

Distribuire in Azure 		Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore con velocità effettiva con più altre opzioni.
Creare un'API SQL dell'account Azure Cosmos DB con scalabilità automatica

Distribuire in Azure 		Questo modello crea un account Azure Cosmos per l'API Core (SQL) con un database e un contenitore con velocità effettiva con scalabilità automatica con più altre opzioni.
Creare stored procedure dell'API Core (SQL) di Azure Cosmos DB

Distribuire in Azure 		Questo modello crea un account Azure Cosmos DB per l'API Core (SQL) e un contenitore con una stored procedure, un trigger e una funzione definita dall'utente.
Crea un'app di microservizi Dapr usando app contenitore

Distribuire in Azure 		Creare un'app di microservizi Dapr usando App contenitore.
Crea un'app pub-sub-servicebus dapr usando app contenitore

Distribuire in Azure 		Creare un'app pub-sub servicebus dapr usando App contenitore.
Distribuire Azure Data Explorer DB con la connessione di Cosmos DB

Distribuire in Azure 		Distribuire Azure Data Explorer DB con la connessione Cosmos DB.

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa databaseAccounts/sqlDatabases/containers può essere distribuito con operazioni destinate a:

  • gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2023-03-15-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      options = {
        autoscaleSettings = {
          maxThroughput = int
        }
        throughput = int
      }
      resource = {
        analyticalStorageTtl = int
        clientEncryptionPolicy = {
          includedPaths = [
            {
              clientEncryptionKeyId = "string"
              encryptionAlgorithm = "string"
              encryptionType = "string"
              path = "string"
            }
          ]
          policyFormatVersion = int
        }
        conflictResolutionPolicy = {
          conflictResolutionPath = "string"
          conflictResolutionProcedure = "string"
          mode = "string"
        }
        createMode = "string"
        defaultTtl = int
        id = "string"
        indexingPolicy = {
          automatic = bool
          compositeIndexes = [
            [
              {
                order = "string"
                path = "string"
              }
            ]
          ]
          excludedPaths = [
            {
              path = "string"
            }
          ]
          includedPaths = [
            {
              indexes = [
                {
                  dataType = "string"
                  kind = "string"
                  precision = int
                }
              ]
              path = "string"
            }
          ]
          indexingMode = "string"
          spatialIndexes = [
            {
              path = "string"
              types = [
                "string"
              ]
            }
          ]
        }
        materializedViewDefinition = {
          definition = "string"
          sourceCollectionId = "string"
        }
        partitionKey = {
          kind = "string"
          paths = [
            "string"
          ]
          version = int
        }
        restoreParameters = {
          restoreSource = "string"
          restoreTimestampInUtc = "string"
        }
        uniqueKeyPolicy = {
          uniqueKeys = [
            {
              paths = [
                "string"
              ]
            }
          ]
        }
      }
    }
  })
}

Valori delle proprietà

Impostazioni di scalabilità automatica

Nome Descrizione Valore
maxThroughput Rappresenta la velocità effettiva massima, la risorsa può aumentare le prestazioni. Int

ClientEncryptionIncludedPath

Nome Descrizione Valore
clientEncryptionKeyId Identificatore della chiave di crittografia client da usare per crittografare il percorso. stringa (obbligatorio)
encryptionAlgorithm Algoritmo di crittografia che verrà usato. Ad esempio, AEAD_AES_256_CBC_HMAC_SHA256. stringa (obbligatorio)
encryptionType Tipo di crittografia da eseguire. Ad esempio: deterministico, casuale. stringa (obbligatorio)
sentiero Percorso che deve essere crittografato. stringa (obbligatorio)

ClientEncryptionPolicy

Nome Descrizione Valore
includedPaths Percorsi dell'elemento che richiedono la crittografia insieme alle impostazioni specifiche del percorso. ClientEncryptionIncludedPath[] (obbligatorio)
policyFormatVersion Versione della definizione dei criteri di crittografia client. Le versioni supportate sono 1 e 2. La versione 2 supporta la crittografia id e percorso della chiave di partizione. Int

Vincoli:
Valore minimo = 1
Valore massimo = 2 (obbligatorio)

Components1Jq1T4ISchemasManagedserviceidentityPropertiesUserassignedidentitiesAdditionalproperties

Nome Descrizione Valore

CompositePath

Nome Descrizione Valore
ordine Ordinamento per i percorsi compositi. 'crescente'
'decrescente'
sentiero Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) corda

ConflictResolutionPolicy

Nome Descrizione Valore
conflictResolutionPath Percorso di risoluzione dei conflitti nel caso della modalità LastWriterWins. corda
conflictResolutionProcedure Procedura per risolvere i conflitti in caso di modalità personalizzata. corda
modo Indica la modalità di risoluzione dei conflitti. 'Custom'
'LastWriterWins'

ContainerPartitionKey

Nome Descrizione Valore
gentile Indica il tipo di algoritmo utilizzato per il partizionamento. Per MultiHash sono supportate più chiavi di partizione (fino a tre massime) per la creazione di contenitori 'Hash'
'MultiHash'
'Range'
Percorsi Elenco di percorsi che usano i dati all'interno del contenitore che possono essere partizionati string[]
Versione Indica la versione della definizione della chiave di partizione Int

Vincoli:
Valore minimo = 1
Valore massimo = 2

CreateUpdateOptionsOrSqlContainerGetPropertiesOptions

Nome Descrizione Valore
autoscaleSettings Specifica le impostazioni di scalabilità automatica. impostazione di scalabilità automaticaImpostazioni di scalabilità automatica
Velocità effettiva Unità richiesta al secondo. Ad esempio, "velocità effettiva": 10000. Int

ExcludedPath

Nome Descrizione Valore
sentiero Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) corda

IncludedPath

Nome Descrizione Valore
Indici Elenco di indici per questo percorso indici[]
sentiero Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) corda

Indici

Nome Descrizione Valore
Datatype Tipo di dati a cui viene applicato il comportamento di indicizzazione. 'LineString'
'MultiPolygon'
'Number'
'Point'
'Poligono'
'String'
gentile Indica il tipo di indice. 'Hash'
'Range'
'Spaziale'
precisione Precisione dell'indice. -1 è la precisione massima. Int

IndexingPolicy

Nome Descrizione Valore
Automatico Indica se i criteri di indicizzazione sono automatici Bool
compositeIndexes Elenco di elenco di percorsi compositi CompositePath [][]
excludedPaths Elenco di percorsi da escludere dall'indicizzazione ExcludedPath []
includedPaths Elenco di percorsi da includere nell'indicizzazione IncludedPath []
indexingMode Indica la modalità di indicizzazione. 'coerente'
'lazy'
'none'
spatialIndexes Elenco di specifiche spaziali SpatialSpec []

ManagedServiceIdentity

Nome Descrizione Valore
digitare Tipo di identità usata per la risorsa. Il tipo 'SystemAssigned,UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'None' rimuoverà tutte le identità dal servizio. 'Nessuno'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco delle identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome Descrizione Valore

MaterializedViewDefinition

Nome Descrizione Valore
definizione La definizione deve essere una query SQL che verrebbe usata per recuperare i dati dal contenitore di origine per popolare nel contenitore Vista materializzata. stringa (obbligatorio)
sourceCollectionId Nome del contenitore di origine in cui verrà creata la vista materializzata. stringa (obbligatorio)

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers

Nome Descrizione Valore
identità Identità per la risorsa. ManagedServiceIdentity
ubicazione Posizione del gruppo di risorse a cui appartiene la risorsa. corda
nome Nome della risorsa stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: databaseAccounts/sqlDatabases
proprietà Proprietà per creare e aggiornare il contenitore Azure Cosmos DB. SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (obbligatorio)
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2023-03-15-preview"

ResourceRestoreParameters

Nome Descrizione Valore
restoreSource ID dell'account di database ripristinabile da cui deve essere avviato il ripristino. Ad esempio: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} corda
restoreTimestampInUtc Ora di ripristino dell'account (formato ISO-8601). corda

SpatialSpec

Nome Descrizione Valore
sentiero Percorso a cui si applica il comportamento di indicizzazione. I percorsi di indice iniziano in genere con radice e terminano con caratteri jolly (/path/*) corda
Tipi Elenco del tipo spaziale del percorso Matrice di stringhe contenente uno dei seguenti elementi:
'LineString'
'MultiPolygon'
'Point'
'Poligono'

SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties

Nome Descrizione Valore
Opzioni Coppia chiave-valore di opzioni da applicare per la richiesta. Corrisponde alle intestazioni inviate con la richiesta. CreateUpdateOptionsOrSqlContainerGetPropertiesOptions
risorsa Formato JSON standard di un contenitore SqlContainerResourceOrSqlContainerGetPropertiesResource (obbligatorio)

SqlContainerResourceOrSqlContainerGetPropertiesResource

Nome Descrizione Valore
analyticalStorageTtl TTL analitico. Int
clientEncryptionPolicy Criteri di crittografia client per il contenitore. ClientEncryptionPolicy
conflictResolutionPolicy Criteri di risoluzione dei conflitti per il contenitore. ConflictResolutionPolicy
createMode Enumerazione per indicare la modalità di creazione della risorsa. 'Default'
'PointInTimeRestore'
'Restore'
defaultTtl Durata predefinita Int
Id Nome del contenitore SQL di Cosmos DB stringa (obbligatorio)
indexingPolicy Configurazione dei criteri di indicizzazione. Per impostazione predefinita, l'indicizzazione è automatica per tutti i percorsi dei documenti all'interno del contenitore IndexingPolicy
materializedViewDefinition Configurazione per la definizione di viste materializzate. Questa operazione deve essere specificata solo per la creazione di un contenitore vista materializzata. MaterializedViewDefinition
partitionKey Configurazione della chiave di partizione da usare per il partizionamento dei dati in più partizioni ContainerPartitionKey
restoreParameters Parametri per indicare le informazioni sul ripristino ResourceRestoreParameters
uniqueKeyPolicy Configurazione dei criteri chiave univoca per specificare vincoli di univocità per i documenti nella raccolta nel servizio Azure Cosmos DB. UniqueKeyPolicy

Tag

Nome Descrizione Valore

UniqueKey

Nome Descrizione Valore
Percorsi L'elenco dei percorsi deve essere univoco per ogni documento nel servizio Azure Cosmos DB string[]

UniqueKeyPolicy

Nome Descrizione Valore
uniqueKeys Elenco di chiavi univoche in che applicano vincoli di univocità per i documenti nella raccolta nel servizio Azure Cosmos DB. UniqueKey []