NOVIDADES

Novidades no 2.0

A versão do driver Go 2.0 oferece suporte à autenticação OpenID Connect (OIDC), fornece uma experiência de tempo limite de operações (CSOT) mais tranquila do lado do cliente e implementa um código Go mais claro e idiomático ao simplificar APIs, melhorar as descrições de erros e simplificar a estrutura do pacote do driver .

Você pode saber mais sobre essas alterações nesta seção ou visualizando o Guia de2.0 migração v no código-fonte do driver Go no GitHub.

Esta versão inclui as seguintes melhorias e correções:

• Suporte para autenticação OpenID Connect (OIDC). Para saber mais, consulte a seção MONGODB-OIDC do guia Mecanismos de autenticação empresarial.

• Você pode acessar a API GridFS a partir do mongo pacote . Em versões anteriores, você poderia acessar as funções GridFS a partir do gridfs pacote separado, mas essa funcionalidade agora está mesclada com o pacote principal do mongo driver. Para saber mais, consulte o guia GridFS .

• O campo Comment em qualquer estrutura de opções obtém um valor do tipo any em vez do tipo string. Para definir esse campo, você pode usar o método SetComment() e passar um parâmetro do tipo any.

• Atualizações nos documentos de evento de monitoramento:

  • As estruturas CommandStartedEvent e CommandFinishedEvent têm um único campo ServerConnectionID do tipo int64 para capturar o ID da conexão.

  • O campo ConnectionID da estrutura PoolEvent obtém um valor do tipo int64 em vez de uint64.

  Para visualizar exemplos de documentos de evento , consulte os guias de monitoramento.

• A Session interface é convertida em uma estrutura. Consulte o guia Transações para saber mais.

• O Distinct() método retorna uma estrutura que pode ser decodificada em um tipo especificado. Consulte o guia Retrieve Distinct Values (Recuperar valores distintos) para saber mais.

• O IndexView.DropOne() método retorna somente um erro, se presente. Em versões anteriores, este método também retornou a resposta do servidor , que continha o número de índices descartados.Consulte a seção Remover um índice do guia Índices para saber mais.

• Atualizações no padrão do construtor para tipos no options pacote. O padrão mantém uma fatia das funções de definição, portanto, você não pode definir dados diretamente para um objeto de opções. Geralmente, esta atualização não altera a forma como você cria e utiliza opções. Para saber mais, consulte o recurso JIRA ticket.

• O driver não é mais compatível com o erro de alerta mongo.ErrUnacknowledgedWrite se uma operação de gravação não for confirmada. Para confirmar que o servidor reconheceu uma operação de gravação, você deve acessar a propriedade Acknowledged a partir da estrutura de resultados retornada pelo método de gravação.

  O exemplo a seguir mostra como confirmar a confirmação de uma operação de inserção:

  res, err := coll.InsertOne(context.TODO(), bson.D{{"x", 2}})
  if err != nil {
     panic(err)
  }
  fmt.Print(res.Acknowledged)

• Você pode definir opções para transações executadas em uma determinada sessão criando uma TransactionOptions instância e passando a instância para o SetDefaultTransactionOptions() método do SessionOptions tipo. Para saber mais, consulte a seção Opções de sessão e transação do guia Transações.

• O método Collection.Clone() não retorna um erro.

• Renomeia o canonical parâmetro do UnmarshalExtJSON() método canonicalOnly para. Se você definir canonicalOnly truecomo, o método retornará um erro se o JSON estendido não for ordenado no modo canônico. Se definido false como, o método pode desordenar JSON estendido canônico ou relaxado. Para saber mais, consulte a documentação da API UnmarshardExtJSON().

Novidades no 1.17

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

• Adiciona suporte para autenticação OpenID Connect (OIDC). Para saber mais, consulte a seção MONGODB-OIDC do guia Mecanismos de autenticação empresarial.

• Adiciona suporte para queries de intervalo de Queryable Encryption (QE). Para usar esse recurso, seu aplicativo deve se conectar ao MongoDB Server 8.0 ou posterior. Para obter mais informações sobre queries de intervalo de QE, consulte Queryable Encryption no manual do MongoDB Server .

• Adiciona suporte para o MongoDB Server 8.0, exceto para o recurso de escrita em massa do cliente .

• Amplia o tipo IndexView para incluir os métodos DropOneWithKey() e DropWithKey() para que você possa descartar índices usando suas especificações de chave em vez de seus nomes.

Para obter mais informações sobre as alterações nesta versão, consulte as 1.17 notas de versão v no Github.

Novidades no 1.16

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

• Adiciona suporte para especificar um tipo de índice ao criar um índice de Atlas Search .

• Reduz o uso de memória quando o algoritmo de compressão zstd está ativado.

• Atualiza alguns requisitos de dependência. Para obter uma lista de atualizações, consulte a seção "Dependências de atualização" das notas de versão v .1.16

Para obter mais informações sobre essas alterações, consulte as notas de versão v1.16 no Github.

Novidades em 1.15.1

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

• Corrige um possível vazamento de conexão em que a desconexão de um cluster de conjunto de réplicas deixaa para trás rttMonitor conexões.

• Adiciona suporte para a especificação manual de um valor de maxTimeMS para operações de leitura e agregação quando um tempo limite para todo o cliente e um tempo limite de operação são definidos.

• Adiciona um método RemainingBatchLength() que você pode chamar em um fluxo de alteração.

Para obter mais informações sobre essas alterações, consulte as notas de versão v1.15.1 no Github.

Novidades no 1.15

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

• A rotatividade de conexão pode ser atenuada definindo um tempo limite em todo o cliente especificando a opção de conexão timeoutMS ou chamando a função SetTimeout(). Quando o tempo limite é definido, o driver tenta reutilizar uma conexão após o tempo limite de uma operação e aguarda até um segundo para verificar se a conexão pode ser reutilizada antes de fechá-la.

• Os eventos do pool de conexões incluem um campo Duration para medir a duração do checkout e o tempo total necessário para estabelecer uma conexão.

Novidades no 1.14

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

• As versões do Go anteriores à 1.18 não são mais suportadas.

• No caso de um tempo limite tipo heartbeat, as operações em andamento são canceladas preventivamente.

• As cadeias de conexão que incluem o prefixo "mongodb+srv://" podem conter letras maiúsculas no nome do host SRV.

Novidades no 1.13

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

• Registro para seleção de servidor e SDAM. Para saber mais sobre registro em log, consulte a documentação de Log .

• Métodos do tipo Collection que permitem gerenciar índices de pesquisa de forma programática.

• Os eventos event.CommandStartedEvent e event.CommandFinishedEvent retornam o campo DatabaseName. Esse campo também está incluído nos análogos do log de comandos.

• Em uma topologia fragmentada, ao selecionar um servidor para tentar novamente uma query malsucedida, o driver exclui o servidor usado para a tentativa inicial. Em vez disso, se houver mais de uma instância de mongos qualificada, o driver selecionará aleatoriamente uma. As instâncias não saudáveis são automaticamente excluídas da seleção.

• O streaming do SDAM é desabilitado por padrão no AWS Lambda e plataformas semelhantes de função como serviço (FaaS). Você pode habilitar o monitoramento usando a opção serverMonitoringMode de URI .

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 de bson.RawValue vazio com um tipo inválido ou desordena 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

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

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