Atualizar versões do driver
Nesta página
Visão geral
Esta página descreve as alterações que você deve fazer no seu aplicação ao atualizar para uma nova versão do driver C.
Antes de atualizar, execute as seguintes ações:
Certifique-se de que a nova versão do driver C seja compatível com as versões do MongoDB Server às quais seu aplicação se conecta e com a plataforma em que seu aplicação é executado. Para obter informações sobre compatibilidade de versões, consulte a página Compatibilidade do driver C.
Resolva quaisquer alterações significativas entre a versão atual do driver que seu aplicação usa e a versão de atualização planejada na seção Alterações significativas. Para saber mais sobre as alterações de compatibilidade da versão do MongoDB Server , consulte a seção Alterações de compatibilidade da versão do servidor .
Dica
Para minimizar o número de alterações que seu aplicação exige ao atualizar as versões do driver no futuro, use a API estável. Para saber mais, consulte o Guia de API estável .
Mudanças de última hora
Observação
O driver C segue o controle de versão semântica. O driver pode quebrar a compatibilidade de sistemas de compilação ou de pacote em qualquer versão. As versões de patch podem reverter alterações acidentais de quebra da API.
Uma alteração significativa é uma alteração de uma convenção ou comportamento a partir de uma versão específica do driver. Esse tipo de alteração pode impedir que seu aplicativo funcione corretamente se não for resolvido antes de atualizar o driver.
As alterações interruptivas nesta seção são categorizadas pela versão do driver que as introduziram. Ao atualizar as versões do driver, resolva todas as alterações interruptivas entre a versão atual e a atualizada.
Exemplo
Atualização da versão 1.26
Se você estiver atualizando o driver C da versão 1.26 para a versão 1.27, resolva todas as alterações significativas listadas para as versões 1.27.0 a 1.27.6, se houver.
Versão 1.24.0 Alterações interruptivas
A versão 1.24.0 do libmongoc, uma das bibliotecas que constituem o driver C, introduz a seguinte alteração interruptiva para trás:
Requer a versão 7.0 e posterior do MongoDB Server para usar a Queryable Encryption.
Alterações na compatibilidade da versão do servidor
Uma alteração de compatibilidade de versão do servidor é uma modificação no driver que descontinua o suporte para um conjunto de versões do Servidor MongoDB.
O driver interrompe o suporte para uma versão do Servidor MongoDB após atingir o fim da vida útil (EOL).
Para saber mais sobre o suporte do MongoDB para produtos EOL, consulte a Política de Suporte Legado.
Versão 1.28.0 Alterações na compatibilidade com a versão
Esta versão do driver elimina o suporte para as versões 3.6 e anteriores do MongoDB Server . Para usar qualquer driver da versão 1.28.0 e posterior, o MongoDB Server deve ser da versão 4.0 ou posterior. Esta versão do driver oferece suporte aos recursos do MongoDB Server 8.0 . Para saber como atualizar seu sistema do MongoDB Server , consulte Notas de versão no manual do MongoDB Server .