Partilhar via

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 sua conta do Azure Cosmos DB para 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 nem diminui a capacidade do banco de dados em nenhum momento. Esse processo não afeta os 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 seus clientes para uma versão compatível com a versão da API para a qual você está atualizando antes de atualizar sua conta do Azure Cosmos DB para MongoDB.

Aviso

Neste momento, apenas as contas qualificadas que utilizam 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 tíquete de suporte.

Atualize a sua versão

  1. Inicie sessão no Portal do Azure.

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

    Captura de ecrã de como verificar a versão atual da sua conta MongoDB a partir do portal do Azure.

  3. No menu à esquerda, abra o Features painel. Este painel mostra os recursos de nível de conta que estão disponíveis para sua conta de banco 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. Registre um tíquete de suporte, se for esse o caso.

    Captura de ecrã da página de funcionalidades para0 atualizar 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, dependendo da sua versão atual).

    Captura de tela da orientação de atualização e a opção selecionar atualização.

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

  7. Seguem-se algumas considerações após a atualização da sua conta:

    1. Se tiver atualizado 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 conexão antiga que executa a versão 3.2 não é interrompida. Para garantir uma experiência consistente, todas as suas aplicações devem utilizar o novo ponto final.

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

Importante

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. Este ponto de extremidade pode ter pequenas diferenças se a sua conta tiver sido criada numa Nuvem do Azure Soberana, Governamental ou Restrita.

Se você estiver atualizando a partir da versão 3.2, precisará substituir o ponto de extremidade existente em seus aplicativos e drivers que se conectam a essa conta de banco 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 agora são necessários para executar operações de classificação em vários campos para garantir um desempenho estável e alto para essas consultas. Certifique-se de que esses índices compostos sejam criados para que suas classificações de vários campos sejam bem-sucedidas.

Faça o downgrade da sua versão

Você também pode fazer o downgrade da sua conta para 4.0 ou 3.6 através das mesmas etapas na seção atualizar sua versão .

  1. Se você atualizou de 3.2 para e deseja fazer o downgrade de volta para 3.2, volte 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 executando a versão 3.2.

  2. Altere a cadeia de conexão em seu aplicativo.

Conteúdos relacionados