Partilhar via

Microsoft.DocumentDB databaseAccounts/sqlDatabases/containers 2025-04-15

Definição de recursos do bíceps

O tipo de recurso databaseAccounts/sqlDatabases/containers pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers, adicione o seguinte Bicep ao seu modelo.

resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2025-04-15' = {
  parent: resourceSymbolicName
  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'
      defaultTtl: int
      fullTextPolicy: {
        defaultLanguage: 'string'
        fullTextPaths: [
          {
            language: 'string'
            path: 'string'
          }
        ]
      }
      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'
            ]
          }
        ]
        vectorIndexes: [
          {
            path: 'string'
            type: 'string'
          }
        ]
      }
      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'
  }
}

Valores de propriedade

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers

Nome Descrição Valor
localização O local do grupo de recursos ao qual o recurso pertence. corda
nome O nome do recurso string (obrigatório)
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.		 Nome simbólico para recurso do tipo: databaseAccounts/sqlDatabases
propriedades Propriedades para criar e atualizar o contêiner do Azure Cosmos DB. SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (obrigatório)
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

AutoscaleSettings

Nome Descrição Valor
maxTaxa de transferência Representa a taxa de transferência máxima, até a qual o recurso pode ser dimensionado. Int

ClientEncryptionIncludedPath

Nome Descrição Valor
clientEncryptionKeyId O identificador da chave de criptografia do cliente a ser usada para criptografar o caminho. string (obrigatório)
encryptionAlgoritmo O algoritmo de encriptação que será usado. Ex: - AEAD_AES_256_CBC_HMAC_SHA256. string (obrigatório)
encryptionType O tipo de criptografia a ser executada. Ex: - determinístico, randomizado. string (obrigatório)
caminho Caminho que precisa ser criptografado. string (obrigatório)

ClientEncryptionPolicy

Nome Descrição Valor
incluídosCaminhos Caminhos do item que precisam de criptografia junto com configurações específicas de caminho. ClientEncryptionIncludedPath[] (obrigatório)
policyFormatVersion Versão da definição da política de criptografia do cliente. As versões suportadas são 1 e 2. A versão 2 suporta encriptação de id e caminho de chave de partição. Int

Restrições:
Valor mínimo = 1
Valor máximo = 2 (obrigatório)

CompositePath

Nome Descrição Valor
Ordem / Encomenda Ordem de classificação para caminhos compostos. 'Ascendente'
'descendente'
caminho O caminho ao qual o comportamento de indexação se aplica. Os caminhos de índice normalmente começam com raiz e terminam com curinga (/path/*) corda

ComputedProperty

Nome Descrição Valor
nome O nome de uma propriedade calculada, por exemplo - "cp_lowerName" corda
consulta A consulta que avalia o valor da propriedade calculada, por exemplo - "SELECT VALUE LOWER(c.name) FROM c" corda

Resolução de ConflitosPolítica

Nome Descrição Valor
conflictResolutionPath O caminho de resolução de conflitos no caso do modo LastWriterWins. corda
conflictResolutionProcedure O procedimento para resolver conflitos no caso do modo personalizado. corda
modo Indica o modo de resolução de conflitos. 'Personalizado'
'LastWriterWins'

ContainerPartitionKey

Nome Descrição Valor
tipo Indica o tipo de algoritmo usado para particionamento. Para MultiHash, várias chaves de partição (até três no máximo) são suportadas para criação de contêiner 'Hash'
'MultiHash'
'Gama'
Caminhos Lista de caminhos usando quais dados dentro do contêiner podem ser particionados string[]
versão Indica a versão da definição de chave de partição Int

Restrições:
Valor mínimo = 1
Valor máximo = 2

CreateUpdateOptionsOrSqlContainerGetPropertiesOptions

Nome Descrição Valor
autoscaleConfigurações Especifica as configurações de dimensionamento automático. Nota: A taxa de transferência ou autoscaleSettings é necessária, mas não ambas. AutoscaleSettings
capacidade de processamento Solicite unidades por segundo. Por exemplo, "taxa de transferência": 10000. Int

Caminho Excluído

Nome Descrição Valor
caminho O caminho ao qual o comportamento de indexação se aplica. Os caminhos de índice normalmente começam com raiz e terminam com curinga (/path/*) corda

FullTextPath

Nome Descrição Valor
Idioma O idioma do campo de texto completo no documento. corda
caminho O caminho para o campo de texto completo no documento. string (obrigatório)

Política de Texto Completo

Nome Descrição Valor
defaultLanguage O idioma padrão para caminhos de texto completo. corda
fullTextPaths Lista de caminhos de texto completo FullTextPath[]

Caminho Incluído

Nome Descrição Valor
índices Lista de índices para este caminho Índices[]
caminho O caminho ao qual o comportamento de indexação se aplica. Os caminhos de índice normalmente começam com raiz e terminam com curinga (/path/*) corda

Índices

Nome Descrição Valor
Tipo de dados O tipo de dados ao qual o comportamento de indexação é aplicado. 'LineString'
'Multipolígono'
'Número'
'Ponto'
'Polígono'
'String'
tipo Indica o tipo de índice. 'Hash'
'Gama'
'Espacial'
precisão A precisão do índice. -1 é a precisão máxima. Int

Política de Indexação

Nome Descrição Valor
Automático Indica se a política de indexação é automática Bool
compositeIndexes Lista de caminhos compostos CompositePath [][]
excludedCaminhos Lista de caminhos a excluir da indexação Caminho Excluído[]
incluídosCaminhos Lista de caminhos a incluir na indexação IncludedPath[]
indexaçãoModo de indexação Indica o modo de indexação. 'Consistente'
'Preguiçoso'
'nenhuma'
spatialIndexes Lista de especificidades espaciais SpatialSpec[]
vectorIndexes Lista de caminhos a serem incluídos na indexação vetorial VectorIndex[]

ResourceRestoreParameters

Nome Descrição Valor
restaurarFonte A id da conta de banco de dados restaurável a partir da qual a restauração deve ser iniciada. Por exemplo: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} corda
restoreTimestampInUtc Tempo para o qual a conta tem de ser restaurada (formato ISO-8601). corda
restoreWithTtlDisabled Especifica se a conta restaurada terá o Time-To-Live desabilitado após a restauração bem-sucedida. Bool

SpatialSpec

Nome Descrição Valor
caminho O caminho ao qual o comportamento de indexação se aplica. Os caminhos de índice normalmente começam com raiz e terminam com curinga (/path/*) corda
tipos Lista do tipo espacial do caminho Matriz de cadeia de caracteres contendo qualquer uma das:
'LineString'
'Multipolígono'
'Ponto'
'Polígono'

SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties

Nome Descrição Valor
Opções Um par de opções chave-valor a ser aplicado para a solicitação. Isso corresponde aos cabeçalhos enviados com a solicitação. CreateUpdateOptionsOrSqlContainerGetPropertiesOptions
recurso O formato JSON padrão de um contêiner SqlContainerResourceOrSqlContainerGetPropertiesResource (obrigatório)

SqlContainerResourceOrSqlContainerGetPropertiesResource

Nome Descrição Valor
analíticoStorageTtl TTL analítico. Int
clientEncryptionPolicy A política de criptografia do cliente para o contêiner. ClientEncryptionPolicy
computedProperties Lista de propriedades computadas ComputedProperty[]
resolução de conflitosPolítica A política de resolução de conflitos para o contêiner. Resolução de ConflitosPolítica
createMode Enum para indicar o modo de criação de recursos. 'Inadimplência'
'Restaurar'
padrãoTtl Tempo de vida padrão Int
fullTextPolicy A política de Texto Completo para o contêiner. Política de Texto Completo
ID Nome do contêiner SQL do Cosmos DB string (obrigatório)
indexaçãoPolítica A configuração da política de indexação. Por padrão, a indexação é automática para todos os caminhos de documentos dentro do contêiner IndexaçãoPolítica
partitionKey A configuração da chave de partição a ser usada para particionar dados em várias partições ContainerPartitionKey
restoreParameters Parâmetros para indicar as informações sobre a restauração ResourceRestoreParameters
uniqueKeyPolicy A configuração de política de chave exclusiva para especificar restrições de exclusividade em documentos na coleção no serviço Azure Cosmos DB. UniqueKeyPolicy
vectorEmbeddingPolicy A política de incorporação de vetores para o contêiner. VectorEmbeddingPolicy

Etiquetas

Nome Descrição Valor

Chave Única

Nome Descrição Valor
Caminhos A lista de caminhos deve ser exclusiva para cada documento no serviço Azure Cosmos DB string[]

UniqueKeyPolicy

Nome Descrição Valor
uniqueKeys Lista de chaves exclusivas que impõe restrição de exclusividade em documentos na coleção no serviço Azure Cosmos DB. UniqueKey []

Incorporação vetorial

Nome Descrição Valor
Tipo de dados Indica o tipo de dados do vetor. «Float32»
'int8'
'uint8' (obrigatório)
dimensões O número de dimensões no vetor. int (obrigatório)
distanceFunction A função de distância a ser usada para o cálculo de distância entre vetores. 'cosseno'
'pontoproduto'
«Euclidiano» (obrigatório)
caminho O caminho para o campo de vetor no documento. string (obrigatório)

VectorEmbeddingPolicy

Nome Descrição Valor
vectorEmbeddings Lista de incorporações vetoriais VectorEmbedding[]

Índice vetorial

Nome Descrição Valor
caminho O caminho para o campo de vetor no documento. string (obrigatório)
tipo O tipo de índice do vetor. Atualmente, flat, diskANN e quantizedFlat são suportados. 'diskANN'
'Plano'
'quantizedFlat' (obrigatório)

Exemplos de uso

Exemplos de início rápido do Azure

Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep Descrição
API SQL da conta do Azure Cosmos DB com de armazenamento analítico Este modelo cria uma conta do Azure Cosmos para API Core (SQL) com um banco de dados e contêiner configurado com repositório analítico.
Criar uma conta gratuita do Azure Cosmos DB Este modelo cria uma conta de camada gratuita do Azure Cosmos DB para API SQL com um banco de dados com taxa de transferência e contêiner compartilhados.
Criar uma conta do Azure Cosmos DB para a API Core (SQL) Este modelo cria uma conta do Azure Cosmos para API Core (SQL) com um banco de dados e contêiner com taxa de transferência com várias outras opções.
Criar uma API SQL de conta do Azure Cosmos DB com de dimensionamento automático Este modelo cria uma conta do Azure Cosmos para API Core (SQL) com um banco de dados e contêiner com taxa de transferência de dimensionamento automático com várias outras opções.
Criar procedimentos armazenados da API do Azure Cosmos DB Core (SQL) Este modelo cria uma conta do Azure Cosmos DB para a API Core (SQL) e um contêiner com um procedimento armazenado, gatilho e função definida pelo usuário.
Cria um aplicativo de microsserviços Dapr usando o Container Apps Crie um aplicativo de microsserviços Dapr usando Aplicativos de Contêiner.
Cria um aplicativo de barramento de serviço pub-sub Dapr usando Aplicativos de Contêiner Crie um aplicativo de barramento de serviço pub-sub Dapr usando Aplicativos de Contêiner.
Implantar o Banco de Dados do Azure Data Explorer com o de conexão do Cosmos DB Implante o Banco de Dados do Azure Data Explorer com conexão do Cosmos DB.

Definição de recurso de modelo ARM

O tipo de recurso databaseAccounts/sqlDatabases/containers pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers",
  "apiVersion": "2025-04-15",
  "name": "string",
  "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",
      "defaultTtl": "int",
      "fullTextPolicy": {
        "defaultLanguage": "string",
        "fullTextPaths": [
          {
            "language": "string",
            "path": "string"
          }
        ]
      },
      "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" ]
          }
        ],
        "vectorIndexes": [
          {
            "path": "string",
            "type": "string"
          }
        ]
      },
      "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"
  }
}

Valores de propriedade

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers

Nome Descrição Valor
Versão da API A versão api '2025-04-15'
localização O local do grupo de recursos ao qual o recurso pertence. corda
nome O nome do recurso string (obrigatório)
propriedades Propriedades para criar e atualizar o contêiner do Azure Cosmos DB. SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (obrigatório)
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers'

AutoscaleSettings

Nome Descrição Valor
maxTaxa de transferência Representa a taxa de transferência máxima, até a qual o recurso pode ser dimensionado. Int

ClientEncryptionIncludedPath

Nome Descrição Valor
clientEncryptionKeyId O identificador da chave de criptografia do cliente a ser usada para criptografar o caminho. string (obrigatório)
encryptionAlgoritmo O algoritmo de encriptação que será usado. Ex: - AEAD_AES_256_CBC_HMAC_SHA256. string (obrigatório)
encryptionType O tipo de criptografia a ser executada. Ex: - determinístico, randomizado. string (obrigatório)
caminho Caminho que precisa ser criptografado. string (obrigatório)

ClientEncryptionPolicy

Nome Descrição Valor
incluídosCaminhos Caminhos do item que precisam de criptografia junto com configurações específicas de caminho. ClientEncryptionIncludedPath[] (obrigatório)
policyFormatVersion Versão da definição da política de criptografia do cliente. As versões suportadas são 1 e 2. A versão 2 suporta encriptação de id e caminho de chave de partição. Int

Restrições:
Valor mínimo = 1
Valor máximo = 2 (obrigatório)

CompositePath

Nome Descrição Valor
Ordem / Encomenda Ordem de classificação para caminhos compostos. 'Ascendente'
'descendente'
caminho O caminho ao qual o comportamento de indexação se aplica. Os caminhos de índice normalmente começam com raiz e terminam com curinga (/path/*) corda

ComputedProperty

Nome Descrição Valor
nome O nome de uma propriedade calculada, por exemplo - "cp_lowerName" corda
consulta A consulta que avalia o valor da propriedade calculada, por exemplo - "SELECT VALUE LOWER(c.name) FROM c" corda

Resolução de ConflitosPolítica

Nome Descrição Valor
conflictResolutionPath O caminho de resolução de conflitos no caso do modo LastWriterWins. corda
conflictResolutionProcedure O procedimento para resolver conflitos no caso do modo personalizado. corda
modo Indica o modo de resolução de conflitos. 'Personalizado'
'LastWriterWins'

ContainerPartitionKey

Nome Descrição Valor
tipo Indica o tipo de algoritmo usado para particionamento. Para MultiHash, várias chaves de partição (até três no máximo) são suportadas para criação de contêiner 'Hash'
'MultiHash'
'Gama'
Caminhos Lista de caminhos usando quais dados dentro do contêiner podem ser particionados string[]
versão Indica a versão da definição de chave de partição Int

Restrições:
Valor mínimo = 1
Valor máximo = 2

CreateUpdateOptionsOrSqlContainerGetPropertiesOptions

Nome Descrição Valor
autoscaleConfigurações Especifica as configurações de dimensionamento automático. Nota: A taxa de transferência ou autoscaleSettings é necessária, mas não ambas. AutoscaleSettings
capacidade de processamento Solicite unidades por segundo. Por exemplo, "taxa de transferência": 10000. Int

Caminho Excluído

Nome Descrição Valor
caminho O caminho ao qual o comportamento de indexação se aplica. Os caminhos de índice normalmente começam com raiz e terminam com curinga (/path/*) corda

FullTextPath

Nome Descrição Valor
Idioma O idioma do campo de texto completo no documento. corda
caminho O caminho para o campo de texto completo no documento. string (obrigatório)

Política de Texto Completo

Nome Descrição Valor
defaultLanguage O idioma padrão para caminhos de texto completo. corda
fullTextPaths Lista de caminhos de texto completo FullTextPath[]

Caminho Incluído

Nome Descrição Valor
índices Lista de índices para este caminho Índices[]
caminho O caminho ao qual o comportamento de indexação se aplica. Os caminhos de índice normalmente começam com raiz e terminam com curinga (/path/*) corda

Índices

Nome Descrição Valor
Tipo de dados O tipo de dados ao qual o comportamento de indexação é aplicado. 'LineString'
'Multipolígono'
'Número'
'Ponto'
'Polígono'
'String'
tipo Indica o tipo de índice. 'Hash'
'Gama'
'Espacial'
precisão A precisão do índice. -1 é a precisão máxima. Int

Política de Indexação

Nome Descrição Valor
Automático Indica se a política de indexação é automática Bool
compositeIndexes Lista de caminhos compostos CompositePath [][]
excludedCaminhos Lista de caminhos a excluir da indexação Caminho Excluído[]
incluídosCaminhos Lista de caminhos a incluir na indexação IncludedPath[]
indexaçãoModo de indexação Indica o modo de indexação. 'Consistente'
'Preguiçoso'
'nenhuma'
spatialIndexes Lista de especificidades espaciais SpatialSpec[]
vectorIndexes Lista de caminhos a serem incluídos na indexação vetorial VectorIndex[]

ResourceRestoreParameters

Nome Descrição Valor
restaurarFonte A id da conta de banco de dados restaurável a partir da qual a restauração deve ser iniciada. Por exemplo: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} corda
restoreTimestampInUtc Tempo para o qual a conta tem de ser restaurada (formato ISO-8601). corda
restoreWithTtlDisabled Especifica se a conta restaurada terá o Time-To-Live desabilitado após a restauração bem-sucedida. Bool

SpatialSpec

Nome Descrição Valor
caminho O caminho ao qual o comportamento de indexação se aplica. Os caminhos de índice normalmente começam com raiz e terminam com curinga (/path/*) corda
tipos Lista do tipo espacial do caminho Matriz de cadeia de caracteres contendo qualquer uma das:
'LineString'
'Multipolígono'
'Ponto'
'Polígono'

SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties

Nome Descrição Valor
Opções Um par de opções chave-valor a ser aplicado para a solicitação. Isso corresponde aos cabeçalhos enviados com a solicitação. CreateUpdateOptionsOrSqlContainerGetPropertiesOptions
recurso O formato JSON padrão de um contêiner SqlContainerResourceOrSqlContainerGetPropertiesResource (obrigatório)

SqlContainerResourceOrSqlContainerGetPropertiesResource

Nome Descrição Valor
analíticoStorageTtl TTL analítico. Int
clientEncryptionPolicy A política de criptografia do cliente para o contêiner. ClientEncryptionPolicy
computedProperties Lista de propriedades computadas ComputedProperty[]
resolução de conflitosPolítica A política de resolução de conflitos para o contêiner. Resolução de ConflitosPolítica
createMode Enum para indicar o modo de criação de recursos. 'Inadimplência'
'Restaurar'
padrãoTtl Tempo de vida padrão Int
fullTextPolicy A política de Texto Completo para o contêiner. Política de Texto Completo
ID Nome do contêiner SQL do Cosmos DB string (obrigatório)
indexaçãoPolítica A configuração da política de indexação. Por padrão, a indexação é automática para todos os caminhos de documentos dentro do contêiner IndexaçãoPolítica
partitionKey A configuração da chave de partição a ser usada para particionar dados em várias partições ContainerPartitionKey
restoreParameters Parâmetros para indicar as informações sobre a restauração ResourceRestoreParameters
uniqueKeyPolicy A configuração de política de chave exclusiva para especificar restrições de exclusividade em documentos na coleção no serviço Azure Cosmos DB. UniqueKeyPolicy
vectorEmbeddingPolicy A política de incorporação de vetores para o contêiner. VectorEmbeddingPolicy

Etiquetas

Nome Descrição Valor

Chave Única

Nome Descrição Valor
Caminhos A lista de caminhos deve ser exclusiva para cada documento no serviço Azure Cosmos DB string[]

UniqueKeyPolicy

Nome Descrição Valor
uniqueKeys Lista de chaves exclusivas que impõe restrição de exclusividade em documentos na coleção no serviço Azure Cosmos DB. UniqueKey []

Incorporação vetorial

Nome Descrição Valor
Tipo de dados Indica o tipo de dados do vetor. «Float32»
'int8'
'uint8' (obrigatório)
dimensões O número de dimensões no vetor. int (obrigatório)
distanceFunction A função de distância a ser usada para o cálculo de distância entre vetores. 'cosseno'
'pontoproduto'
«Euclidiano» (obrigatório)
caminho O caminho para o campo de vetor no documento. string (obrigatório)

VectorEmbeddingPolicy

Nome Descrição Valor
vectorEmbeddings Lista de incorporações vetoriais VectorEmbedding[]

Índice vetorial

Nome Descrição Valor
caminho O caminho para o campo de vetor no documento. string (obrigatório)
tipo O tipo de índice do vetor. Atualmente, flat, diskANN e quantizedFlat são suportados. 'diskANN'
'Plano'
'quantizedFlat' (obrigatório)

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

Modelo Descrição
API SQL da conta do Azure Cosmos DB com de armazenamento analítico

Implantar no Azure 		Este modelo cria uma conta do Azure Cosmos para API Core (SQL) com um banco de dados e contêiner configurado com repositório analítico.
Criar uma conta gratuita do Azure Cosmos DB

Implantar no Azure 		Este modelo cria uma conta de camada gratuita do Azure Cosmos DB para API SQL com um banco de dados com taxa de transferência e contêiner compartilhados.
Criar uma conta do Azure Cosmos DB para a API Core (SQL)

Implantar no Azure 		Este modelo cria uma conta do Azure Cosmos para API Core (SQL) com um banco de dados e contêiner com taxa de transferência com várias outras opções.
Criar uma API SQL de conta do Azure Cosmos DB com de dimensionamento automático

Implantar no Azure 		Este modelo cria uma conta do Azure Cosmos para API Core (SQL) com um banco de dados e contêiner com taxa de transferência de dimensionamento automático com várias outras opções.
Criar procedimentos armazenados da API do Azure Cosmos DB Core (SQL)

Implantar no Azure 		Este modelo cria uma conta do Azure Cosmos DB para a API Core (SQL) e um contêiner com um procedimento armazenado, gatilho e função definida pelo usuário.
Cria um aplicativo de microsserviços Dapr usando o Container Apps

Implantar no Azure 		Crie um aplicativo de microsserviços Dapr usando Aplicativos de Contêiner.
Cria um aplicativo de barramento de serviço pub-sub Dapr usando Aplicativos de Contêiner

Implantar no Azure 		Crie um aplicativo de barramento de serviço pub-sub Dapr usando Aplicativos de Contêiner.
Implantar o Banco de Dados do Azure Data Explorer com o de conexão do Cosmos DB

Implantar no Azure 		Implante o Banco de Dados do Azure Data Explorer com conexão do Cosmos DB.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso databaseAccounts/sqlDatabases/containers pode ser implantado com operações direcionadas:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2025-04-15"
  name = "string"
  parent_id = "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"
        defaultTtl = int
        fullTextPolicy = {
          defaultLanguage = "string"
          fullTextPaths = [
            {
              language = "string"
              path = "string"
            }
          ]
        }
        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"
              ]
            }
          ]
          vectorIndexes = [
            {
              path = "string"
              type = "string"
            }
          ]
        }
        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"
            }
          ]
        }
      }
    }
  }
}

Valores de propriedade

Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers

Nome Descrição Valor
localização O local do grupo de recursos ao qual o recurso pertence. corda
nome O nome do recurso string (obrigatório)
parent_id A ID do recurso que é o pai para este recurso. ID para recurso do tipo: databaseAccounts/sqlDatabases
propriedades Propriedades para criar e atualizar o contêiner do Azure Cosmos DB. SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties (obrigatório)
etiquetas Etiquetas de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2025-04-15"

AutoscaleSettings

Nome Descrição Valor
maxTaxa de transferência Representa a taxa de transferência máxima, até a qual o recurso pode ser dimensionado. Int

ClientEncryptionIncludedPath

Nome Descrição Valor
clientEncryptionKeyId O identificador da chave de criptografia do cliente a ser usada para criptografar o caminho. string (obrigatório)
encryptionAlgoritmo O algoritmo de encriptação que será usado. Ex: - AEAD_AES_256_CBC_HMAC_SHA256. string (obrigatório)
encryptionType O tipo de criptografia a ser executada. Ex: - determinístico, randomizado. string (obrigatório)
caminho Caminho que precisa ser criptografado. string (obrigatório)

ClientEncryptionPolicy

Nome Descrição Valor
incluídosCaminhos Caminhos do item que precisam de criptografia junto com configurações específicas de caminho. ClientEncryptionIncludedPath[] (obrigatório)
policyFormatVersion Versão da definição da política de criptografia do cliente. As versões suportadas são 1 e 2. A versão 2 suporta encriptação de id e caminho de chave de partição. Int

Restrições:
Valor mínimo = 1
Valor máximo = 2 (obrigatório)

CompositePath

Nome Descrição Valor
Ordem / Encomenda Ordem de classificação para caminhos compostos. 'Ascendente'
'descendente'
caminho O caminho ao qual o comportamento de indexação se aplica. Os caminhos de índice normalmente começam com raiz e terminam com curinga (/path/*) corda

ComputedProperty

Nome Descrição Valor
nome O nome de uma propriedade calculada, por exemplo - "cp_lowerName" corda
consulta A consulta que avalia o valor da propriedade calculada, por exemplo - "SELECT VALUE LOWER(c.name) FROM c" corda

Resolução de ConflitosPolítica

Nome Descrição Valor
conflictResolutionPath O caminho de resolução de conflitos no caso do modo LastWriterWins. corda
conflictResolutionProcedure O procedimento para resolver conflitos no caso do modo personalizado. corda
modo Indica o modo de resolução de conflitos. 'Personalizado'
'LastWriterWins'

ContainerPartitionKey

Nome Descrição Valor
tipo Indica o tipo de algoritmo usado para particionamento. Para MultiHash, várias chaves de partição (até três no máximo) são suportadas para criação de contêiner 'Hash'
'MultiHash'
'Gama'
Caminhos Lista de caminhos usando quais dados dentro do contêiner podem ser particionados string[]
versão Indica a versão da definição de chave de partição Int

Restrições:
Valor mínimo = 1
Valor máximo = 2

CreateUpdateOptionsOrSqlContainerGetPropertiesOptions

Nome Descrição Valor
autoscaleConfigurações Especifica as configurações de dimensionamento automático. Nota: A taxa de transferência ou autoscaleSettings é necessária, mas não ambas. AutoscaleSettings
capacidade de processamento Solicite unidades por segundo. Por exemplo, "taxa de transferência": 10000. Int

Caminho Excluído

Nome Descrição Valor
caminho O caminho ao qual o comportamento de indexação se aplica. Os caminhos de índice normalmente começam com raiz e terminam com curinga (/path/*) corda

FullTextPath

Nome Descrição Valor
Idioma O idioma do campo de texto completo no documento. corda
caminho O caminho para o campo de texto completo no documento. string (obrigatório)

Política de Texto Completo

Nome Descrição Valor
defaultLanguage O idioma padrão para caminhos de texto completo. corda
fullTextPaths Lista de caminhos de texto completo FullTextPath[]

Caminho Incluído

Nome Descrição Valor
índices Lista de índices para este caminho Índices[]
caminho O caminho ao qual o comportamento de indexação se aplica. Os caminhos de índice normalmente começam com raiz e terminam com curinga (/path/*) corda

Índices

Nome Descrição Valor
Tipo de dados O tipo de dados ao qual o comportamento de indexação é aplicado. 'LineString'
'Multipolígono'
'Número'
'Ponto'
'Polígono'
'String'
tipo Indica o tipo de índice. 'Hash'
'Gama'
'Espacial'
precisão A precisão do índice. -1 é a precisão máxima. Int

Política de Indexação

Nome Descrição Valor
Automático Indica se a política de indexação é automática Bool
compositeIndexes Lista de caminhos compostos CompositePath [][]
excludedCaminhos Lista de caminhos a excluir da indexação Caminho Excluído[]
incluídosCaminhos Lista de caminhos a incluir na indexação IncludedPath[]
indexaçãoModo de indexação Indica o modo de indexação. 'Consistente'
'Preguiçoso'
'nenhuma'
spatialIndexes Lista de especificidades espaciais SpatialSpec[]
vectorIndexes Lista de caminhos a serem incluídos na indexação vetorial VectorIndex[]

ResourceRestoreParameters

Nome Descrição Valor
restaurarFonte A id da conta de banco de dados restaurável a partir da qual a restauração deve ser iniciada. Por exemplo: /subscriptions/{subscriptionId}/providers/Microsoft.DocumentDB/locations/{location}/restorableDatabaseAccounts/{restorableDatabaseAccountName} corda
restoreTimestampInUtc Tempo para o qual a conta tem de ser restaurada (formato ISO-8601). corda
restoreWithTtlDisabled Especifica se a conta restaurada terá o Time-To-Live desabilitado após a restauração bem-sucedida. Bool

SpatialSpec

Nome Descrição Valor
caminho O caminho ao qual o comportamento de indexação se aplica. Os caminhos de índice normalmente começam com raiz e terminam com curinga (/path/*) corda
tipos Lista do tipo espacial do caminho Matriz de cadeia de caracteres contendo qualquer uma das:
'LineString'
'Multipolígono'
'Ponto'
'Polígono'

SqlContainerCreateUpdatePropertiesOrSqlContainerGetProperties

Nome Descrição Valor
Opções Um par de opções chave-valor a ser aplicado para a solicitação. Isso corresponde aos cabeçalhos enviados com a solicitação. CreateUpdateOptionsOrSqlContainerGetPropertiesOptions
recurso O formato JSON padrão de um contêiner SqlContainerResourceOrSqlContainerGetPropertiesResource (obrigatório)

SqlContainerResourceOrSqlContainerGetPropertiesResource

Nome Descrição Valor
analíticoStorageTtl TTL analítico. Int
clientEncryptionPolicy A política de criptografia do cliente para o contêiner. ClientEncryptionPolicy
computedProperties Lista de propriedades computadas ComputedProperty[]
resolução de conflitosPolítica A política de resolução de conflitos para o contêiner. Resolução de ConflitosPolítica
createMode Enum para indicar o modo de criação de recursos. 'Inadimplência'
'Restaurar'
padrãoTtl Tempo de vida padrão Int
fullTextPolicy A política de Texto Completo para o contêiner. Política de Texto Completo
ID Nome do contêiner SQL do Cosmos DB string (obrigatório)
indexaçãoPolítica A configuração da política de indexação. Por padrão, a indexação é automática para todos os caminhos de documentos dentro do contêiner IndexaçãoPolítica
partitionKey A configuração da chave de partição a ser usada para particionar dados em várias partições ContainerPartitionKey
restoreParameters Parâmetros para indicar as informações sobre a restauração ResourceRestoreParameters
uniqueKeyPolicy A configuração de política de chave exclusiva para especificar restrições de exclusividade em documentos na coleção no serviço Azure Cosmos DB. UniqueKeyPolicy
vectorEmbeddingPolicy A política de incorporação de vetores para o contêiner. VectorEmbeddingPolicy

Etiquetas

Nome Descrição Valor

Chave Única

Nome Descrição Valor
Caminhos A lista de caminhos deve ser exclusiva para cada documento no serviço Azure Cosmos DB string[]

UniqueKeyPolicy

Nome Descrição Valor
uniqueKeys Lista de chaves exclusivas que impõe restrição de exclusividade em documentos na coleção no serviço Azure Cosmos DB. UniqueKey []

Incorporação vetorial

Nome Descrição Valor
Tipo de dados Indica o tipo de dados do vetor. «Float32»
'int8'
'uint8' (obrigatório)
dimensões O número de dimensões no vetor. int (obrigatório)
distanceFunction A função de distância a ser usada para o cálculo de distância entre vetores. 'cosseno'
'pontoproduto'
«Euclidiano» (obrigatório)
caminho O caminho para o campo de vetor no documento. string (obrigatório)

VectorEmbeddingPolicy

Nome Descrição Valor
vectorEmbeddings Lista de incorporações vetoriais VectorEmbedding[]

Índice vetorial

Nome Descrição Valor
caminho O caminho para o campo de vetor no documento. string (obrigatório)
tipo O tipo de índice do vetor. Atualmente, flat, diskANN e quantizedFlat são suportados. 'diskANN'
'Plano'
'quantizedFlat' (obrigatório)