Atualizar a versão da API da sua conta do Azure Cosmos DB para MongoDB

  • Artigo

APLICA-SE A: MongoDB

Este artigo descreve como atualizar a versão da API da API do Azure Cosmos DB para a conta do MongoDB. Após a atualização, pode utilizar a funcionalidade mais recente na API do Azure Cosmos DB para MongoDB. O processo de atualização não interrompe a disponibilidade da sua conta e não consome RU/s nem diminui a capacidade da base de dados em nenhum momento. Não serão afetados por este processo quaisquer dados ou índices existentes.

Ao atualizar para uma nova versão da API, comece com cargas de trabalho de desenvolvimento/teste antes de atualizar as cargas de trabalho de produção. É importante atualizar os seus clientes para uma versão compatível com a versão da API para a qual está a atualizar antes de atualizar a sua conta do Azure Cosmos DB para MongoDB.

Nota

Neste momento, apenas as contas elegíveis que utilizem a versão 3.2 do servidor podem ser atualizadas para a versão 3.6 e superior. Se a sua conta não mostrar a opção de atualização, envie um pedido de suporte.

Atualizar para 4.2, 4.0 ou 3.6

Benefícios da atualização para a versão 4.2:

  • Várias melhorias importantes no pipeline de agregação, como suporte para $merge, Trigonometria, expressões aritméticas e muito mais.
  • Suporte para a encyption do campo do lado do cliente que protege ainda mais a sua base de dados ao permitir que os campos individuais sejam encriptados seletivamente e mantendo a privacidade dos dados encriptados dos utilizadores da base de dados e fornecedores de alojamento.

Benefícios da atualização para a versão 4.0

Seguem-se as novas funcionalidades incluídas na versão 4.0:

  • Suporte para transações de vários documentos em coleções não processadas.
  • Novos operadores de agregação
  • Desempenho de análise melhorado
  • Armazenamento mais rápido e eficiente

Benefícios da atualização para a versão 3.6

Seguem-se as novas funcionalidades incluídas na versão 3.6:

  • Desempenho e estabilidade melhorados
  • Suporte para novos comandos da base de dados
  • Suporte para o pipeline de agregação por fases de agregação novas e predefinidas
  • Suporte para Fluxos de Alterações
  • Suporte para Índices compostos
  • Suporte entre partições para as seguintes operações: atualização, eliminação, contagem e ordenação
  • Desempenho melhorado para as seguintes operações de agregação: $count, $skip, $limit e $group
  • A indexação de carateres universais é agora suportada

Alterações da versão 3.2

  • Por predefinição, a funcionalidade Repetição do Lado do Servidor (SSR) está ativada, pelo que os pedidos da aplicação cliente não irão devolver erros 16500. Em vez disso, os pedidos serão retomados até serem concluídos ou atingirem o tempo limite de 60 segundos.
  • O tempo limite por pedido está definido como 60 segundos.
  • As coleções do MongoDB criadas na nova versão do protocolo de invocação terão apenas a propriedade _id indexada por predefinição.

Ação necessária ao atualizar a partir da versão 3.2

Ao atualizar a partir da versão 3.2, o sufixo do ponto final da conta de base de dados será atualizado para o seguinte formato:

<your_database_account_name>.mongo.cosmos.azure.com

Se estiver a atualizar a partir da versão 3.2, terá de substituir o ponto final existente nas suas aplicações e controladores que se ligam a esta conta de base de dados. Apenas as ligações que utilizarem o novo ponto final terão acesso às funcionalidades da nova versão da API. O ponto final anterior da versão 3.2 deve ter o sufixo .documents.azure.com.

Ao atualizar da versão 3.2 para versões mais recentes, os índices compostos são agora necessários para realizar operações de ordenação em vários campos para garantir um desempenho estável e elevado para estas consultas. Certifique-se de que estes índices compostos são criados para que as ordenações de múltiplos campos sejam bem-sucedidas.

Nota

Este ponto final poderá ter ligeiras diferenças se a sua conta tiver sido criada numa Cloud Soberana, Governamental ou Restrita do Azure.

Como atualizar

  1. Inicie sessão no portal do Azure.

  2. Navegue para a sua conta do Azure Cosmos DB para MongoDB. Abra o painel Descrição Geral e verifique se a versão atual do Servidor é 3.2 ou 3.6.

    Verifique a versão atual da sua conta do MongoDB no portal do Azure.

  3. No menu esquerdo, abra o Features painel. Este painel mostra as funcionalidades ao nível da conta que estão disponíveis para a sua conta de base de dados.

  4. Selecione a linha Upgrade MongoDB server version. Se não vir esta opção, a sua conta poderá não ser elegível para esta atualização. Se for esse o caso, envie um pedido de suporte .

    Abra o painel Funcionalidades e atualize a sua conta.

  5. Veja as informações apresentadas sobre a atualização. Selecione Set server version to 4.2 (ou 4.0 ou 3.6 consoante a sua versão atual).

    Reveja a documentação de orientação de atualização e selecione atualizar.

  6. Depois de iniciar a atualização, o menu Funcionalidade fica a cinzento e o estado está definido como Pendente. A atualização demora cerca de 15 minutos a ser concluída. Este processo não afetará a funcionalidade ou as operações existentes da sua conta de base de dados. Após a conclusão, o estado da versão do servidor Atualizar MongoDB mostrará a versão atualizada. Contacte o suporte se existir um problema ao processar o seu pedido.

  7. Seguem-se algumas considerações após atualizar a sua conta:

    1. Se atualizou a partir da versão 3.2, volte ao painel Descrição geral e copie a nova cadeia de ligação para utilizar na sua aplicação. A cadeia de ligação antiga que executa a versão 3.2 não será interrompida. Para garantir uma experiência consistente, todas as suas aplicações devem utilizar o novo ponto final.

    2. Se tiver atualizado a partir da versão 3.6, a sua cadeia de ligação existente será atualizada para a versão especificada e deverá continuar a ser utilizada.

Como mudar para uma versão anterior

Também pode mudar a sua conta para 4.0 ou 3.6 através dos mesmos passos na secção "Como Atualizar".

Se atualizou da versão 3.2 para a 3.2 e pretende mudar novamente para a versão 3.2, pode simplesmente voltar a utilizar a cadeia de ligação anterior (3.2) com o anfitrião accountname.documents.azure.com que permanece ativo após a atualização, com a versão 3.2.

Passos seguintes