NOVIDADES

Dica

Notas de versão

Para saber mais sobre alterações e atualizações entre versões, você pode ler as notas de versão publicado com o código-fonte do driver.

Descubra as novidades de cada versão:

Versão 1.12.1
Versão 1.12

Novidades em 1.12.1

O 1.12 A versão do driver Go inclui as seguintes melhorias e correções:

O driver libera conexões ao encerrar uma sessão. Isso evita vazamento de conexões quando um usuário executa uma transação enquanto está conectado a um balanceador de carga.
O driver não lança um erro de tempo de execução quando você desordena um tipo bson.RawValue vazio com um tipo inválido ou ordena um ponteiro nil de uma instância ReadConcern .
Definir options.LogComponentAll como o componente de log corretamente resulta na publicação de logs em todos os componentes.

Novidades no 1.12

Importante

Aviso de depreciação

Os métodos mongo.NewClient() e client.Connect() estão obsoletos. Você pode criar um cliente e conectá-lo em uma chamada usando o método mongo.Connect() .

Novos recursos do 1.12 A versão do driver Go inclui:

Queryable Encryption

Esta versão do driver adiciona compatibilidade para Queryable Encryption (QE). Para saber mais sobre os requisitos para usar o recurso QE, consulte a Tabela de compatibilidade do driver de Queryable Encryption.

O método ClientEncryption.CreateEncryptedCollection() cria automaticamente chaves de criptografia de dados quando você cria uma nova coleção criptografada. Para saber como usar o recurso QE, consulte o Início Rápido da Queryable Encryption no manual do Servidor.

Interface de registro em log

Agora você pode registrar eventos de gerenciamento de conexão e execução de comando usando a interface de log de LogSink.

Para saber mais, consulte o guia de Fundamentosde Registro .

Opções adicionais de ordenação de BSON

Esta versão do driver adiciona recursos ao pacote options para especificar como o driver ordena e desordena o BSON.

O exemplo a seguir mostra como definir as opções BSON em seu Client. As opções especificam os seguintes comportamentos:

O driver volta para as marcações de estrutura json se as marcações de estrutura bson estiverem ausentes.
O driver desordena tipos de mapa Go nil como documentos BSON vazios.
O driver ordena os tipos de fatia nil Go como arrays BSON vazias.

bsonOpts := &options.BSONOptions{
     UseJSONStructTags: true,
     NilMapAsEmpty:     true,
     NilSliceAsEmpty:   true,
}
options.Client().SetBSONOptions(bsonOpts)

Para ver um exemplo completo de como especificar e implementar o tipo BSONOptions, consulte a documentação da API.

Especificação simplificada de preocupação de gravação

Esta versão do driver simplifica a API WriteConcern . Para saber mais sobre as mudanças, consulte Preocupação de gravação.

Alterações adicionais

Suporte para autenticação com funções AWS IAM no EKS.
Adição do método Cursor.SetBatchSize() para permitir a especificação do tamanho dos lotes buscados ao iterar por meio de um cursor.
Adição do método UnmarshalValue() para permitir a desordenação dos valores de BSON ordenados com o método MarshalValue().

Voltar

Referência rápida

Exemplos de uso