Perguntas frequentes sobre Azure DocumentDB (com compatibilidade com MongoDB)

Obtenha respostas às perguntas frequentes sobre o Azure DocumentDB (com compatibilidade com MongoDB): o que é, quão compatível é com o MongoDB, as poupanças de TCO possíveis e como migrar.

General

O que é o Azure DocumentDB?

O Azure DocumentDB (com compatibilidade com MongoDB) é uma base de dados de documentos totalmente gerida e compatível com MongoDB no Azure. Os drivers, ferramentas e código da aplicação MongoDB existentes conectam-se sem alterações, e Azure DocumentDB suporta 99,03% de operadores MongoDB. O Azure DocumentDB é construído sobre o DocumentDB, uma base de dados de documentos de código aberto regida pela Linux Foundation, lançada sob a licença MIT e construída sobre PostgreSQL. Para uma introdução, consulte O que é o Azure DocumentDB?.

O Azure DocumentDB é um substituto drop-in para o MongoDB?

Sim, para a maioria das aplicações. O Azure DocumentDB implementa o protocolo wire do MongoDB, pelo que os drivers MongoDB, o MongoDB Compass, o shell MongoDB (mongosh) e frameworks como Mongoose e Spring Data ligam-se sem alterações de código. Azure DocumentDB suporta 99,03% dos operadores de consulta, projeção, atualização e agregação do MongoDB. Para verificar a sua própria carga de trabalho, execute a avaliação de compatibilidade gratuita na extensão de migração Azure DocumentDB para Visual Studio Code. Consulte compatibilidade com MongoDB.

Para que cargas de trabalho o Azure DocumentDB é mais adequado?

O Azure DocumentDB adequa-se a qualquer carga de trabalho que corra hoje no MongoDB: aplicações operacionais e transacionais, back-ends web e móveis, gestão de conteúdos e catálogos, análises em tempo real com pipelines de agregação e aplicações de IA que utilizam pesquisa vetorial. O Azure DocumentDB é a opção gerida recomendada para equipas que movem o MongoDB a partir de máquinas virtuais Azure, MongoDB Atlas, Amazon DocumentDB ou servidores locais.

Existem categorias de carga de trabalho além do MongoDB para as quais o Azure DocumentDB é adequado?

O Azure DocumentDB é adequado para novas aplicações e cargas de trabalho orientadas por agentes que precisam de começar rapidamente, iterar rapidamente e escalar de forma eficiente. Fornece um repositório de dados de documentos integrado, uma base de dados vetorial (com DiskANN) e capacidades de pesquisa, tudo gerido e contido na mesma implementação. Isto torna a criação de novas aplicações e frameworks orientados por agentes muito eficiente.

Como é que o Azure DocumentDB se relaciona com o Azure Cosmos DB?

O Azure DocumentDB era anteriormente denominado Azure Cosmos DB baseado em vCore para MongoDB. Tornou-se uma oferta própria para se alinhar com o projeto open-source DocumentDB que o alimenta. A mudança de nome não alterou clusters, cadeias de ligação ou APIs existentes. O Azure DocumentDB e o Azure Cosmos DB for MongoDB (RU) são serviços separados: o Azure DocumentDB utiliza clusters dedicados baseados em vCore, e o Azure Cosmos DB para MongoDB (RU) utiliza o throughput baseado em unidades de pedido.

O Azure DocumentDB é o mesmo que o Amazon DocumentDB?

No. Azure DocumentDB e Amazon DocumentDB são serviços não relacionados de empresas diferentes. Azure DocumentDB é um serviço Microsoft Azure construído sobre o motor DocumentDB de código aberto e suporta 99,03% de operadores MongoDB. O Azure DocumentDB também não tem relação com o serviço original Azure DocumentDB de 2014 a 2017, que se tornou Azure Cosmos DB. Pode migrar do Amazon DocumentDB para o Azure DocumentDB. Consulte as opções de migração.

A licença SSPL do MongoDB aplica-se ao Azure DocumentDB?

No. O Azure DocumentDB não executa o servidor de base de dados MongoDB nem a sua base de código, por isso a Licença Pública do Lado do Servidor (SSPL) do MongoDB não se aplica. O Azure DocumentDB é construído sobre o motor open-source DocumentDB, que é lançado sob a licença permissiva MIT.

Posso executar a mesma base de dados local ou noutras clouds?

Yes. O motor DocumentDB de código aberto que alimenta o Azure DocumentDB corre localmente e em qualquer cloud através do operador DocumentDB Kubernetes. As aplicações utilizam os mesmos drivers compatíveis com MongoDB e a mesma interface em todo o lado, e o Azure DocumentDB suporta replicação intercloud e failover com o DocumentDB auto-hospedado.

Como posso começar a usar o Azure DocumentDB?

Comece pelo nível gratuito, que lhe oferece um cluster dedicado com 32 GB de armazenamento sem custos. Pode criar um cluster a partir do portal Azure, da CLI do Azure, Bicep ou Terraform. Consulte Azure DocumentDB nível gratuito, Quickstart: Azure portal e Quickstart: Bicep.

O Azure DocumentDB oferece um acordo de nível de serviço (SLA)?

Yes. Azure DocumentDB oferece um SLA de disponibilidade de 99,995% para configurações altamente disponíveis. O SLA cobre toda a pilha: base de dados, computação, armazenamento e rede. Clusters de nível gratuito e clusters sem alta disponibilidade têm termos diferentes. Para mais detalhes, consulte o SLA para serviços online.

Custos e preços

Como funciona o preço para o Azure DocumentDB?

A tarifação do Azure DocumentDB baseia-se em duas coisas: computação (a camada de cluster, em vCores e memória) e armazenamento. Pode dimensionar a computação e o armazenamento de forma independente. Não existem unidades de pedido, nem cobranças de I/O por operação, nem cobranças separadas para backups ou armazenamento de alto desempenho. A capacidade reservada poupa até 40% com um compromisso de um ano e até 60% com três anos, e Azure DocumentDB é elegível para o plano de poupança para bases de dados. Consulte a definição de preços do Azure DocumentDB.

Quão mais barato é o Azure DocumentDB do que o MongoDB Atlas?

Azure DocumentDB custa pelo menos 40% menos do que o MongoDB Atlas para computação equivalente. A maioria dos clientes poupa mais de 50% no total, porque Azure DocumentDB não cobra separadamente por backups ou rede. Para uma comparação funcionalidade a funcionalidade, consulte Comparar Azure DocumentDB com MongoDB Atlas.

O que está incluído no preço sem custo adicional?

O Azure DocumentDB inclui estes sem custo adicional:

  • Backups, com restauração pontual durante até 35 dias para níveis de Produção (M30 e SKUs maiores).
  • Armazenamento premium SSD v2 de alto desempenho.
  • Pesquisa de texto integrada e pesquisa vetorial, sem camada de pesquisa separada.
  • Suporte com o seu plano suporte do Azure existente.
  • A extensão de migração do Azure DocumentDB e a avaliação de compatibilidade.

Posso reduzir custos para ambientes de desenvolvimento e testes?

Yes. O Azure DocumentDB permite-lhe executar clusters sem alta disponibilidade para desenvolvimento e teste, o que custa menos do que um cluster de produção altamente disponível. Também podes usar o nível gratuito para desenvolvimento, testes e pequenas cargas de trabalho.

O Azure DocumentDB é contabilizado para o meu compromisso do Azure?

O Azure DocumentDB é um serviço Azure de primeira parte, pelo que a utilização aparece na sua fatura Azure e está coberta pelo seu plano de suporte do Azure.

Escalão gratuito

O Azure DocumentDB tem uma camada gratuita?

Yes. A camada gratuita do Azure DocumentDB oferece-lhe um cluster dedicado com 32 GB de armazenamento, gratuito durante toda a vida útil da sua conta Azure. Isso é 64 vezes o armazenamento do nível gratuito do MongoDB Atlas, que oferece 512 MB. Os clusters de nível gratuito são aprovisionados em segundos. Cada subscrição do Azure pode ter um cluster de nível gratuito. Veja Azure DocumentDB nível gratuito.

Quais são os limites do nível gratuito?

A camada gratuita do Azure DocumentDB não inclui alta disponibilidade, autenticação Microsoft Entra ID, backup e restauro, índices vetoriais DiskANN ou HNSW, nem registo de diagnóstico. O Azure DocumentDB coloca em pausa os clusters da camada gratuita após 60 dias de inatividade. O nível gratuito está disponível num subconjunto das regiões do Azure. Consulte a camada gratuita do Azure DocumentDB para a lista atual. O nível gratuito destina-se a ser usado para prototipagem inicial e validação funcional. Para necessidades maiores, recomenda-se escalar para um nível pago.

Posso atualizar um cluster de nível gratuito para um nível pago?

Yes. Pode atualizar um cluster da camada gratuita do Azure DocumentDB para qualquer camada paga no local. Os seus dados, cadeia de ligação e regras de rede mantêm-se iguais. Não podes mover um cluster pago de volta para o nível gratuito.

Compatibilidade com MongoDB

Que versões e funcionalidades do MongoDB o Azure DocumentDB suporta?

Azure DocumentDB suporta as versões 5.0, 6.0, 7.0 e 8.0 do protocolo de fio MongoDB e 99.03% dos operadores de consulta, projeção, atualização e agregação do MongoDB. As contagens percentuais baseiam-se nos operadores MongoDB voltados para o utilizador suportados. Exclui comandos administrativos, que o Azure DocumentDB gere como um serviço de plataforma. Para mais detalhes, consulte Compatibilidade com a Linguagem de Consulta MongoDB (MQL) e a compatibilidade com funcionalidades MongoDB.

Os drivers e ferramentas do MongoDB são compatíveis com o Azure DocumentDB?

Yes. Qualquer driver que suporte o protocolo de fio MongoDB liga-se ao Azure DocumentDB, incluindo os drivers oficiais do MongoDB para Node.js, Python, Java, .NET, Go e outras linguagens diferentes. Ferramentas como o MongoDB Compass e o shell MongoDB (mongosh) também funcionam. Motores de armazenamento específicos do MongoDB e extensões do lado do servidor não são suportados, porque o Azure DocumentDB não executa o servidor MongoDB.

Existem diferenças de comportamento que devo esperar após a migração?

A maioria das aplicações comporta-se da mesma forma. Podem surgir diferenças em alguns comandos administrativos, que o Azure DocumentDB gere por si, e no pequeno conjunto de operadores que não são suportados. Execute a avaliação de compatibilidade antes de migrar e teste a sua carga de trabalho num cluster de preparação. Consulte a compatibilidade do MongoDB para a lista de operadores não suportados.

Como posso verificar se a minha aplicação é compatível antes de migrar?

Efetue a avaliação gratuita de compatibilidade na extensão de migração Azure DocumentDB para Visual Studio Code. Analisa a implementação do seu MongoDB de origem e reporta funcionalidades, comandos, sintaxe de consulta e tipos de índice não suportados. Depois execute os seus testes de integração num cluster de testes, que pode ser um cluster de nível gratuito. Consulte Avaliação e planeamento da preparação para a migração.

Migration

Posso migrar a minha base de dados MongoDB existente para o Azure DocumentDB?

Yes. O Azure DocumentDB suporta migrações do MongoDB Atlas em qualquer nuvem, Amazon DocumentDB, MongoDB auto-hospedado em máquinas virtuais e MongoDB auto-hospedado nas instalações. As ferramentas de migração são gratuitas para usar. Consulte as opções de migração.

Que ferramentas posso usar para migrar para o Azure DocumentDB?

Pode usar qualquer uma destas ferramentas:

Posso migrar sem tempo de inatividade?

Sim, com um tempo de inatividade mínimo. Uma migração online copia os seus dados e depois mantém o destino sincronizado com a sua origem através de change streams enquanto a sua aplicação continua a funcionar. Muda a sua aplicação para o Azure DocumentDB no cutover. A migração online requer que os fluxos de alterações estejam ativados na fonte e um oplog suficientemente grande para cobrir a janela de migração.

Como migro do MongoDB Atlas para o Azure DocumentDB?

Execute a avaliação de compatibilidade, crie um cluster Azure DocumentDB dimensionado para a sua carga de trabalho e, em seguida, execute uma migração online com a extensão ou Azure Database Migration Service de migração. Clusters Atlas no Azure, AWS e Google Cloud são todos fontes suportadas. Consulte as opções de migração.

Como migro do Amazon DocumentDB para o Azure DocumentDB?

Ative fluxos de alterações no seu cluster Amazon DocumentDB, execute a avaliação de compatibilidade e, em seguida, execute uma migração online com a extensão ou Azure Database Migration Service de migração. Consulte as Opções de migração.

Segurança

Como é que os dados estão protegidos em repouso no Azure DocumentDB?

O Azure DocumentDB encripta todos os dados em repouso por predefinição. Pode utilizar chaves geridas por serviço (SMK) ou chaves geridas pelo cliente (CMK) para uma camada adicional de encriptação. Consulte Encriptação em repouso.

Que encriptação ao nível de transporte é que o Azure DocumentDB utiliza?

O Azure DocumentDB impõe a Segurança da Camada de Transporte (TLS) para todas as ligações de cliente e serviço. Certifique-se de que os seus clientes utilizam versões atuais de TLS e certificados raiz confiáveis.

Como gero a autenticação e o controlo de acessos?

O Azure DocumentDB suporta autenticação nativa (incorporada) e Microsoft Entra ID para gestão centralizada de identidade e acesso. Pode criar utilizadores e funções granulares ao nível da base de dados e da coleção, e utilizar identidades geridas para autenticação serviço-a-serviço. Consulte a autenticação do Microsoft Entra ID e as melhores práticas de segurança.

Yes. As regras de firewall restringem o acesso público, e o Azure Private Link expõe o seu cluster Azure DocumentDB através de endpoints privados na sua rede virtual. Os endpoints privados são acessíveis a partir de recursos da rede virtual e de redes locais ligadas a essa rede virtual. Veja Usar o Azure Private Link e Gerir o acesso público.

Como devo gerir as chaves de encriptação ao usar CMK?

Quando utiliza chaves geridas pelo cliente com o Azure DocumentDB, gere o ciclo de vida das chaves no Azure Key Vault. Siga estas práticas:

  • Ative o registo e alertas no cofre de chaves.
  • Tranque o recurso do cofre de chaves.
  • Planeie a rotação de chaves.
  • Certifique-se de que o Azure DocumentDB tem acesso de rede ao cofre de chaves para obter a chave.

Para mais informações, consulte Configurar CMK.

Quais são as práticas recomendadas de monitorização e registo de segurança?

Monitorize e alerte sobre métricas gratuitas do Azure DocumentDB através do Azure Monitor ou monitorização detalhada ao nível de pedidos no Log Analytics, o que implica um custo no espaço de trabalho Log Analytics. Auditar ações administrativas e configurar alertas para atividade suspeita. O registo de diagnóstico não está disponível no nível gratuito.

Connectivity

Como é que os clientes se ligam a um cluster Azure DocumentDB?

Os clientes ligam-se com drivers padrão do MongoDB, utilizando a cadeia de ligação do cluster. Pode ligar-se através do endpoint público, protegido por regras de firewall, ou de forma privada através do Private Link. Consulte os quickstarts da linguagem para exemplos, como Quickstart: Node.js.

Que opções existem para restringir o acesso à rede?

Use regras de firewall de cluster para restringir endereços IP de origem, Private Link para criar endpoints privados nas suas redes virtuais, e grupos de segurança de rede e peering de rede virtual para um controlo mais preciso. Veja Gerenciar acesso público e Utilizar o Azure Private Link.

Posso ligar-me a partir de redes locais?

Yes. Recursos locais ligados via VPN ou Azure ExpressRoute a uma rede virtual peered podem aceder aos endpoints do Private Link do Azure DocumentDB. Também pode usar o endpoint público com regras de firewall, mas a conectividade privada é recomendada para cargas de trabalho de produção.

Como configuro as strings de ligação e as definições do driver?

Utilize o formato padrão de cadeia de ligação do MongoDB com o seu driver. Inclua opções para TLS e o seu mecanismo de autenticação (nome de utilizador e palavra-passe, ou Microsoft Entra ID). Veja os quickstarts específicos do idioma para exemplos.

Como posso reduzir a latência para utilizadores em múltiplas regiões?

A distância de rede entre a sua aplicação e o cluster afeta a latência. Implemente o seu cluster Azure DocumentDB na mesma região da sua aplicação e adicione réplicas de leitura localmente ou noutras regiões para utilizadores noutros locais. Consulte Melhores práticas de alta disponibilidade e replicação.

Desempenho e dimensionamento

Como posso escalar o desempenho no Azure DocumentDB?

Escale um cluster Azure DocumentDB escolhendo uma camada de cluster maior com mais vCores e memória, e escale o armazenamento separadamente à medida que os seus dados crescem. Aumente a escala adicionando fragmentos. Como computação e armazenamento escalam de forma independente, não precisa de comprar mais computação só para obter mais armazenamento. Consulte Escalar ou configurar um cluster.

Posso reduzir o tamanho de armazenamento do meu cluster?

No. O tamanho do armazenamento só pode ser aumentado, não diminuído.

Quando devo shardar os meus dados?

A maioria das cargas de trabalho não necessita de sharding até que uma base de dados alcance vários terabytes, porque um único nó do Azure DocumentDB suporta até 32 TB de armazenamento. Quando fizer shard, escolha uma chave de shard com alta cardinalidade e distribuição uniforme. Pode particionar coleções existentes online, sem tempo de inatividade. Ver Fragmentação e Indexação.

O mesmo cluster Azure DocumentDB pode suportar tanto coleções sharded como não sharded?

Sim, e este é um padrão comum. Os clusters Azure DocumentDB multi-fragmento podem suportar coleções não fragmentadas onde as coleções não estão distribuídas entre fragmentos e residem inteiramente num único nó. Nesta configuração, múltiplas coleções grandes podem ser separadas em diferentes nós, permitindo uma melhor utilização e gestão dos recursos. Além disso, coleções maiores podem ser fragmentadas, enquanto coleções mais pequenas permanecem sem fragmentar. Por fim, todas as coleções podem ser fragmentadas e distribuídas através dos shards físicos no cluster Azure DocumentDB.

Quais são as melhores práticas para indexação e desempenho das consultas?

Crie índices que correspondam aos seus padrões de consulta, evite análises ilimitadas e reveja planos de consulta com explain() para encontrar gargalos. Utilize o Index Advisor para recomendações sobre consultas comuns. Veja Como ler o explain out.

Como posso monitorizar e resolver problemas de desempenho?

Utilize métricas do Azure Monitor para CPU, memória, armazenamento e IOPS, bem como registos de diagnóstico para capturar consultas lentas. Consulte Monitorizar métricas e Resolver problemas comuns.

O Azure DocumentDB consegue lidar com alta taxa de leitura e escrita?

Yes. O Azure DocumentDB gere cargas de trabalho de alta taxa quando a camada do cluster, o armazenamento e o layout do shard coincidem com a carga de trabalho. Escale o cálculo para maior rendimento, adicione fragmentos para distribuir as escritas e adicione réplicas de leitura para distribuir as leituras.