Compartilhar via


Referência de limites e cotas do serviço Azure DocumentDB

Este documento descreve os limites rígidos e suaves atuais para clusters e operações do Azure DocumentDB. Saiba mais sobre limites de execução de consulta, restrições de indexação, configurações de cluster e limites de autenticação que ajudam você a planejar e otimizar suas implantações do Azure DocumentDB com eficiência.

Limitações de consulta e execução

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

Limitações de execução do MongoDB

  • Tempo de vida máximo da transação: 30 segundos.

  • Tempo de vida do cursor: 10 minutos. Observação: um erro cursorNotFound poderá ocorrer se o cursor exceder seu tempo de vida.

  • Limite de execução de consulta padrão: 120 segundos. Esse limite pode ser substituído para cada consulta usando maxTimeMS no respectivo driver do MongoDB.

Example

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

Tamanho máximo da consulta do MongoDB

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

  • Em clusters fragmentados, se uma consulta efetuar pull de dados em diversos nós o limite desse tamanho de dados será de 1 GB.

Limitações de indexação

O Azure DocumentDB impõe vários limites de indexação para garantir o desempenho ideal e a 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 para o valor do campo _id: 2 KB.

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

  • Máximo padrão: 64.

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

  • Nível máximo de aninhamento para objetos/matrizes inseridos em definições de índice: 6.

  • Um único processo de criação de índice pode estar em andamento na mesma coleção.

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

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

  • Os buids de índice exclusivo são feitos em primeiro plano e bloqueiam gravações na coleção.

Limitações de indexação curinga

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

Limitações de indexação geoespacial

  • Não há suporte para BigPolygons.

  • Índices compostos não dão suporte a índices geoespaciais.

  • A consulta $geoWithin não dá suporte a polígonos com orifícios.

  • O campo key é necessário no estágio de agregação $geoNear.

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

Limitações de índice de texto

  • Somente um índice de texto pode ser configurado em uma coleção.

  • Dá suporte apenas a pesquisas de texto simples; recursos de pesquisa avançada, como pesquisas de expressões regulares, não têm suporte.

  • hint() não é compatível com consultas que usam a expressão $text.

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

  • Não há suporte para tokenização para chinês, japonês, coreano.

  • Não há suporte para geração de tokens que não diferencia maiúsculas de minúsculas.

Limitações de pesquisa de vetor

  • Indexação de vetores de até 2.000 dimensões de tamanho.

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

  • Somente um índice pode ser criado por caminho de vetor.

  • HNSW e DiskANN estão disponíveis em M30 e em camadas de cluster maiores.

Limitações de cluster e shard

O Azure DocumentDB impõe limites específicos à configuração do cluster, à fragmentação física e ao gerenciamento de coleção para garantir o desempenho ideal e a alocação de recursos.

Nível do cluster

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

Fragmentos físicos

  • Máximo: 10

Limitações de coleta

  • Coleções por cluster: 1.000

  • Tamanho da coleção não fragmentado: 32 TiB

Regiões secundárias

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

Limitações do plano gratuito

As limitações a seguir podem ser substituídas se você atualizar para um nível pago

  • Armazenamento máximo: 32 GiB.

  • Backup/restauração sem suporte (disponível em M25+)

  • Não há suporte para alta disponibilidade (HA) (disponível em M30+)

  • Índices vetoriais Hierarchical Navigable Small World (HNSW) não são suportados (disponível a partir do M40+)

  • Não há suporte para registro em log de diagnóstico (disponível apenas em camadas pagas)

  • Não há suporte para a ID do Microsoft Entra

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

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

  • Não há suporte para a transição de uma conta de camada paga para uma camada gratuita.

Limites de nível

As camadas de serviço M10, M20 e M25 têm as seguintes limitações:

  • Dá suporte apenas a um fragmento físico (nó).

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

  • Os tamanhos de armazenamento com suporte 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 novamente para a camada de computação M10, M20 ou M25.

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

Veja a seguir as limitações atuais para configurar a CMK (chave gerenciada pelo cliente) em um Azure DocumentDB:

Limites de replicação e alta disponibilidade dentro da região

O Azure DocumentDB fornece recursos internos de replicação e alta disponibilidade (HA) com limitações específicas para garantir a consistência e o desempenho dos dados em diferentes cenários de implantação.

Replicação entre regiões e dentro da mesma região

  • As seguintes configurações são as mesmas em clusters primários e de réplica e não podem ser alteradas no cluster de réplica:

    • Contagem de fragmentos físicos e de armazenamento

    • Contas de usuário

  • Os seguintes recursos não estão disponíveis em clusters de réplica:

    • PITR (Restauração pontual)

    • HA (alta disponibilidade) na região

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

Controle de autenticação e acesso (controle de acesso baseado em função)

O Azure DocumentDB impõe limites de controle de acesso e autenticação para manter a segurança e gerenciar a alocação de recursos entre contas de usuário 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 da ID do Microsoft Entra tem estas limitações atuais:

Usuários secundários nativos do DocumentDB

O recurso de usuários secundários nativos tem estas limitações:

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

  • O comando Roleinfo não é suportado. Alternativamente, você pode utilizar usersInfo.

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

Limitações diversas

O Azure DocumentDB tem limites mais operacionais e específicos de recursos que se aplicam a vários aspectos do gerenciamento e funcionalidade do cluster.

Uso do shell do Mongo do portal

  • O shell do Mongo do portal pode ser usado por 120 minutos em uma janela de 24 horas.

Tamanho e profundidade do documento

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

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

    • Estruturas de documentos profundamente aninhadas podem afetar o desempenho de consulta e leitura, aumentar a sobrecarga de processamento e reduzir a manutenção.

Limites do Lote

  • Há suporte para ambos os tipos de operações em lote (escrita e em massa).

    • 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 excedem 25.000 gravações falharão.

  • Nenhum limite no número total de operações em lote.