Compartilhar via

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

  • Artigo

APLICA-SE A: MongoDB

Este artigo descreve como atualizar a versão de API do Azure Cosmos DB API para a conta do MongoDB. Após a atualização, você pode usar 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 ou diminui a capacidade do banco de dados em qualquer ponto. Nenhum dado ou índice existente será afetado por esse processo.

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

Observação

Neste momento, somente contas qualificadas que usam a versão 3.2 do servidor podem ser atualizadas para a versão 3.6 e superior. Se sua conta não mostrar a opção de atualização, registre um tíquete de suporte.

Atualização 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 criptografia de campo do lado do cliente que protege ainda mais seu banco de dados, permitindo que os campos individuais sejam criptografados seletivamente e mantendo a privacidade do dado criptografado de usuários e provedores de hospedagem.

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

Veja a seguir os novos recursos incluídos na versão 4.0:

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

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

Veja a seguir os novos recursos incluídos na versão 3.6:

  • Desempenho e estabilidade aprimorados
  • Suporte a novos comandos de banco de dados
  • Suporte a um pipeline de agregação por padrão e novos estágios de agregação
  • Suporte para alterar fluxos
  • Suporte para índices compostos
  • Suporte entre partições para as seguintes operações: atualizar, excluir, contar e classificar
  • Desempenho aprimorado para as seguintes operações agregadas: $count, $skip, $limit e $group
  • A indexação de caractere curinga agora tem suporte

Alterações da versão 3.2

  • Por padrão, o recurso Repetição do lado do servidor (SSR) está habilitado, de modo que as solicitações do aplicativo cliente não retornarão erros 16500. Em vez disso, as solicitações serão retomadas até serem concluídas ou atenderem ao tempo limite de 60 segundos.
  • O tempo limite por solicitação é definido para 60 segundos.
  • Novas coleções do MongoDB criadas por você após a migração só terão a propriedade _id indexada por padrão.

Ação necessária ao atualizar do 3.2

Ao atualizar do 3.2, o sufixo do ponto de extremidade da conta do banco de dados será atualizado para o seguinte formato:

<your_database_account_name>.mongo.cosmos.azure.com

Se você estiver atualizando da versão 3.2, será necessário substituir o ponto de extremidade existente em seus aplicativos e drivers que se conectam a essa conta de banco de dados. Somente as conexões que estão usando o novo ponto de extremidade terão acesso aos recursos na nova versão da API. O ponto de extremidade 3.2 anterior deve ter o sufixo .documents.azure.com.

Ao atualizar da 3.2 para versões mais recentes, os índices compostos agora são necessários para executar operações de classificação em vários campos a fim de garantir um alto desempenho estável para essas consultas. Certifique-se de que esses índices compostos sejam criados para que suas classificações de vários campos tenham sucesso.

Observação

Esse ponto de extremidade pode ter pequenas diferenças caso sua conta tenha sido criada em uma nuvem do Azure Soberana, Governamental ou Restrita.

Como atualizar

  1. Entre no portal do Azure.

  2. Navegue para sua conta do Azure Cosmos DB for MongoDB. Abra o painel Visão geral e verifique se a Versão do servidor atual é 3.2 ou 3.6.

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

  3. No menu à esquerda, abra o painel Features. Este painel mostrará os recursos no nível da conta que estão disponíveis para sua conta do banco de dados.

  4. Selecione a Upgrade MongoDB server version linha. Se você não vir essa opção, sua conta poderá não estar qualificada para essa atualização. Registre um tíquete de suporte se esse for o caso.

    Abra a folha Recursos e atualize sua conta.

  5. Examine as informações exibidas sobre a atualização. Selecione Set server version to 4.2 (ou 4.0 ou 3.6 dependendo da versão atual).

    Examine as diretrizes de atualização e selecione atualizar.

  6. Depois de iniciar a atualização, o menu Recurso ficará esmaecido e o status será definido como Pendente. A atualização leva cerca de 15 minutos para ser concluída. Esse processo não afetará a funcionalidade ou as operações existentes da conta do banco de dados. Após a conclusão, o status Atualizar versão do servidor do MongoDB mostrará a versão atualizada. Entre em contato com o suporte se houver um problema ao processar sua solicitação.

  7. A seguir estão algumas considerações depois de atualizar sua conta:

    1. Se você atualizou da 3.2, volte para o painel Visão geral e copie a nova cadeia de conexão para usar em seu aplicativo. A cadeia de conexão antiga executando a versão 3.2 não será interrompida. Para garantir uma experiência consistente, todos os seus aplicativos devem usar o novo ponto de extremidade.

    2. Se você atualizou da versão 3.6, sua cadeia de conexão existente será atualizada para a versão especificada e deverá continuar a ser usada.

Como fazer downgrade

Você também pode fazer downgrade de sua conta para 4.0 ou 3.6 por meio das mesmas etapas na seção "Como atualizar".

Se você atualizou da versão 3.2 para e quer fazer o downgrade para 3.2, você pode voltar a usar sua cadeia de conexão anterior (3.2) com o host accountname.documents.azure.com, que permanece ativo após a atualização em execução da versão 3.2.

Próximas etapas