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çãoAlteraçõ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 os sistemas de compilação ou a compatibilidade do 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.