Limites e quotas do serviço Azure DocumentDB

Este documento descreve os limites rígidos e flexíveis atuais para clusters e operações do Azure DocumentDB. Aprenda sobre limites de execução de consultas, restrições de indexação, configurações de cluster e limites de autenticação que o ajudam a planear e otimizar eficazmente as suas implementações no Azure DocumentDB.

Limitações de consulta e execução

Os seguintes limites aplicam-se às operações de consulta e à execução de comandos em clusters Azure DocumentDB.

Limitações de execução do MongoDB

  • Vida útil máxima da transação: 30 segundos.

  • Vida útil do cursor: 10 minutos. Nota: Um erro cursorNotFound pode ocorrer se o cursor exceder seu tempo de vida.

  • Limite de execução de consulta padrão: 120 segundos. Este limite pode ser anulado para cada consulta usando o driver MongoDB respetivo com maxTimeMS.

Example

db.collection.find({ field: "value" }).maxTimeMS(5000)

Tamanho máximo de consulta do MongoDB

  • O tamanho máximo de memória para consultas MongoDB depende da camada. Por exemplo, para M80, o limite de tamanho da memória de consulta é de aproximadamente 150 MiB.

  • Em clusters fragmentados, se uma consulta obtiver dados através de nós, o limite do tamanho desses dados é de 1 GB.

Limitações de indexação

O Azure DocumentDB impõe vários limites de indexação para garantir desempenho ótimo e utilização de recursos em diferentes tipos de índice e operações.

Limitações gerais de indexação

  • Número máximo de campos de índice composto: 32.

  • Tamanho máximo do valor do _id campo: 2 KB.

  • Tamanho máximo do caminho do índice: 256B.

  • Máximo padrão: 64.

    • Configurável até: 300 índices por coleção.
  • A classificação é feita na memória e não desce para o índice.

  • Nível máximo de aninhamento para objetos/arrays incorporados nas definições de índice: 6.

  • Uma única compilação de índice pode estar em andamento na mesma coleção.

  • O número de compilações de índice simultâneas em coleções diferentes é configurável (padrão: 2).

  • Use o currentOp comando para exibir o progresso de compilações de índice de longa execução.

  • Compilações de índice exclusivas são feitas em primeiro plano e gravações em bloco na coleção.

Limitações de indexação de wildcards

  • Para índices curinga, se o campo indexado for uma matriz de matrizes, toda a matriz incorporada será tomada como um valor em vez de percorrer seu conteúdo.

Limitações de indexação geoespacial

  • Não há suporte para BigPolygons.

  • Os índices compostos não suportam índices geoespaciais.

  • $geoWithin O Query não suporta polígonos com buracos.

  • O key campo é obrigatório na $geoNear etapa de agregação.

  • Os índices são recomendados, mas não necessários para os operadores de consulta $near e para a etapa de agregação $nearSphere.

Limitações do índice de texto

Os seguintes limites aplicam-se a índices geralmente { field: "text" } disponíveis consultados com $text. Os índices de pesquisa em texto completo em pré-visualização têm limitações separadas.

  • Apenas um índice de texto pode ser definido em uma coleção.

  • Suporta apenas pesquisas de texto simples; Não há suporte para recursos de pesquisa avançada, como pesquisas de expressão regular.

  • hint() não é suportado em combinação com uma consulta que utilize a expressão $text.

  • As operações de classificação não podem usar a ordenação do índice de texto.

  • A tokenização para chinês, japonês e coreano não é suportada.

  • A tokenização insensível a maiúsculas e minúsculas não é suportada.

Limitações de pesquisa de texto completo (pré-visualização)

As seguintes limitações aplicam-se a índices de pesquisa de texto completo em pré-visualização que cria com createSearchIndexes e consulta com $search. Estes índices são separados dos índices de texto geralmente disponíveis. Ativar a pré-visualização não altera índices de texto existentes ou consultas $text existentes.

  • Definir dynamic: false ou omitir dynamic utilizam mapeamentos estáticos. Deve declarar explicitamente todos os campos pesquisáveis sob mappings.fields. A definição dynamic: true faz com que a criação de índice falhe, e mappings.dynamic is not supported in search indexes yet. a criação de índice também falha se mappings.fields estiver em falta ou vazia. Conjuntos de tipos dinâmicos não são suportados.

  • Os tipos de mapeamento objectId, uuid, embeddedDocument, autocomplete e geo não são suportados.

  • Filtros de caracteres, definições de sinónimos e storedSource não são suportados.

  • Os autocompleteoperadores , queryString, e near não são suportados.

  • Os regex operadores e wildcard operadores no interior de $search não são suportados.

  • compound.minimumShouldMatch e os aumentos de pontuação personalizados não são suportados.

  • A $searchMeta etapa, a variável $$SEARCH_META, as contagens, as facetas e o realce não são suportados.

  • A $rankFusion fase não é suportada. Para combinar resultados de palavras-chave e vetoriais, utilize os exemplos de RRF em Hybrid search.

  • A gestão de índices de pesquisa permite a criação e a listagem. Use o comando dropIndexes para eliminar um índice de pesquisa. APIs dedicadas para atualização de índice de pesquisa não são suportadas. Para alterar mapeamentos de campos ou analisadores, crie um índice com um novo nome e atualize as suas consultas para o referenciar.

Para exemplos e restrições de configuração, consulte Analisadores personalizados e Pesquisa estruturada e de texto.

Limitações da pesquisa vetorial

  • Indexação de vetores até 16.000 dimensões (com quantização de produto)

  • A indexação aplica-se a apenas um vetor por caminho.

  • Apenas um índice pode ser criado por caminho vetorial.

  • HNSW e DiskANN estão disponíveis em níveis de cluster M30 e superiores.

Limitações de cluster e fragmentos

O Azure DocumentDB impõe limites específicos à configuração do cluster, sharding físico e gestão de coleções para garantir um desempenho ótimo e alocação de recursos.

Camada de agrupamento

  • Máximo: M200 / 64 vCores / 256 GiB de RAM por shard físico.

Fragmentos físicos

  • Máximo: 10.

Limitações da coleção

  • Tamanho da coleção Unsharded: 32 TiB

Regiões secundárias

  • Máximo: Uma região secundária.

Limitações do escalão livre

As limitações a seguir podem ser substituídas pela atualização para um nível pago

  • Armazenamento máximo: 32 GiB.

  • Backup / restauração não suportada (disponível em M25+)

  • Alta disponibilidade (HA) não é suportada (disponível a partir do M30+)

  • Índices vetoriais hierárquicos navegáveis de mundo pequeno (HNSW) não suportados (disponíveis em M40+)

  • Log de diagnóstico não suportado (disponível apenas em camadas pagas)

  • ID do Microsoft Entra não suportada

  • Nenhum contrato de nível de serviço fornecido (requer que a HA esteja habilitada)

  • Os clusters de camada livre são pausados após 60 dias de inatividade onde não há conexões com o cluster.

  • A transição de uma conta de nível paga para uma conta de nível gratuito não é suportada.

Limites de camadas

Os níveis de serviço M10, M20 e M25 apresentam as seguintes limitações:

  • Suporta apenas um fragmento físico (nó).

  • Projetado para casos de uso de Desenvolvimento/Teste; não há suporte para alta disponibilidade (HA) na região.

  • Os tamanhos de armazenamento suportados incluem 32 GiB, 64 GiB e 128 GiB.

  • Depois que o cluster é dimensionado para a camada M30 ou superior, o cluster não pode ser reduzido para a camada de computação M10, M20 ou M25.

Limitações de criptografia de dados de chave gerenciados pelo cliente

Seguem-se as limitações atuais para configurar a chave gerida pelo cliente (CMK) num Azure DocumentDB:

Limitações de consulta a partir de qualquer nó

A lista seguinte descreve as limitações atuais da consulta proveniente de qualquer nó:

  • Requer um cluster multishard. Não tem qualquer efeito sobre um cluster de um único shard.

Limites de replicação e alta disponibilidade regional

O Azure DocumentDB oferece funcionalidades de replicação e alta disponibilidade (HA) incorporadas com limitações específicas para garantir consistência e desempenho dos dados em diferentes cenários de implementação.

Replicação entre regiões e na mesma região

  • As seguintes configurações são iguais tanto no cluster primário como no de réplica e não podem ser alteradas no cluster de réplica:

    • Armazenamento e contagem de fragmentos físicos

    • Contas de utilizador

  • As seguintes funcionalidades não estão disponíveis em clusters réplica:

    • Restauração em ponto específico no tempo (PITR)

    • Alta disponibilidade (HA) dentro da região

  • A replicação não está disponível em clusters com computação burstable ou clusters de camada gratuita .

Failover entre regiões

  • A promoção graciosa requer que o cluster primário seja acessível para que a fila de replicação possa esvaziar-se. Se a região principal já estiver indisponível, utilize promoção forçada ou failover gerido por serviço em vez disso.
  • O failover gerido por serviço é opcional. Deve estar ativado no cluster primário antes de ocorrer uma falha regional; não pode ser ativado retroativamente durante uma falha.
  • O failover gerido pelo serviço e a promoção gradual requerem uma réplica ativa entre regiões. Réplicas da mesma região não são elegíveis para modos de failover entre regiões.

Autenticação e controlo de acesso (controlo de acesso baseado em funções)

O Azure DocumentDB aplica limites de autenticação e controlo de acesso para manter a segurança e gerir a alocação de recursos entre contas de utilizador e funções.

  • Você pode criar até 100 usuários/funções totais por cluster.

Autenticação do Microsoft Entra ID

O recurso de autenticação do Microsoft Entra ID tem estas limitações atuais:

  • Esta funcionalidade não suporta grupos de ID do Microsoft Entra.

  • Quando o método de autenticação nativo do Banco de Dados de Documentos é desabilitado, o Shell do MongoDB não é suportado no Início rápido do portal do Azure.

Usuários secundários nativos do Banco de Dados de Documentos

A funcionalidade de utilizadores secundários nativos tem as seguintes limitações:

  • O Updateuser comando agora suporta apenas atualizações de senha e não pode modificar outros campos de objeto.

  • O Roleinfo comando não é suportado. Alternativamente, pode usar usersInfo.

  • Não há suporte para atribuição de funções a bancos de dados ou coleções específicos, apenas há suporte para o nível de cluster.

Limitações diversas

O Azure DocumentDB tem limites mais operacionais e específicos de funcionalidades que se aplicam a vários aspetos da gestão e funcionalidade do cluster.

Utilização do shell do Mongo Portal

  • O shell Portal Mongo pode ser usado por 120 minutos dentro de uma janela de 24 horas.

Tamanho e profundidade do documento

  • Tamanho máximo de Notação Binária de Objetos JavaScript (BSON): 16 MB por documento.

  • Nenhum limite fixo de profundidade máxima de aninhamento é imposto.

    • Estruturas documentais profundamente aninhadas podem afetar o desempenho das consultas e leituras, aumentar a sobrecarga de processamento e reduzir a manutenibilidade.

Limites de lotes

  • Ambos os tipos de operação em lote (gravação e em massa) são suportados.

    • Um lote refere-se a uma única solicitação ao servidor.
  • Máximo de gravações por operação em lote: 25.000 gravações.

  • As operações em lote que excederem 25.000 gravações falharão.

  • Não há limite para o número total de operações em lote.