Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.

Comprimir tráfego de rede

Drivers do MongoDB podem compactar as mensagens enviadas para e recebidas do MongoDB Server. Isso reduz a quantidade de transferência de dados para cada operação. A compactação pode melhorar o desempenho em redes restritas e reduzir o custo de transferência de dados associado à execução do MongoDB Atlas.

A compactação opera no nível do wire protocol, portanto, aplica-se a todas as operações que seu aplicativo executa. Se você especificar mais de um algoritmo, o driver usará o primeiro algoritmo da sua lista que o MongoDB Server também suporta.

Os drivers do MongoDB suportam os seguintes algoritmos de compactação:

O MongoDB Atlas cobra pela transferência de dados entre regiões de nuvem, provedores de nuvem e entre sua infraestrutura e o MongoDB Atlas. A compactação de rede reduz a quantidade de dados que seu aplicativo envia e recebe, o que pode diminuir esses custos de transferência de dados. Para saber mais sobre preços, consulte Custos de transferência de dados.

A compactação de rede também traz benefícios de produtividade. Mensagens compactadas levam menos tempo para serem transferidas pela rede, o que pode melhorar os tempos de resposta do seu aplicativo. A compactação também reduz a largura de banda que o tráfego do MongoDB utiliza, o que deixa mais largura de banda disponível para outros aplicativos na mesma rede.

Ao escolher um algoritmo de compactação, considere as seguintes diretrizes:

  • Use o Zstandard para um equilíbrio entre eficiência de compactação e uso de recursos. O Zstandard é uma boa escolha padrão para a maioria dos aplicativos.

  • Use Snappy para aplicativos sensíveis à latência que exigem sobrecarga computacional mínima.

  • Use o zlib para ampla compatibilidade entre drivers e ambientes do MongoDB.

Dica

Monitorar o uso da CPU

A compactação troca largura de banda de rede por uso de CPU. Depois de ativar a compactação de rede, monitore a utilização da CPU do seu aplicativo para confirmar se a compensação beneficia sua carga de trabalho. Para aprender mais sobre essas compensações, consulte a publicação no blog Utilização de CPU e compactação de rede no MongoDB.

A tabela a seguir lista o driver mínimo compatível e a versão do MongoDB Server para cada algoritmo de compactação:

Algoritmo de compactação
Versão mínima do driver
Versão mínima do servidor

3.6

4.2

3.6

4.2

3.11

4.2

Para habilitar a compactação de rede para sua conexão com o MongoDB, instale as dependências necessárias e especifique os algoritmo de compactação que você deseja usar.

A tabela a seguir lista cada algoritmo e a dependência que ele requer, se houver:

Algoritmo de compactação
Dependência

Snappy

Baixar snappy-java, um wrapper JNI Java para a biblioteca Snappy. Para instalar, consulte snappy-java no Maven Central.

zlib

Nenhum. O driver oferece suporte nativo à compactação zlib.

Zstandard

Baixar zstd-jni, um wrapper Java JNI para a biblioteca Zstandard. Para instalar, consulte zstd-jni no Maven Central.

Você pode habilitar a compressão para a conexão com sua instância do MongoDB especificando os algoritmos de uma das seguintes maneiras:

  • Use o parâmetro compressors na sua string de conexão

  • Encadeie o método compressorList() ao método MongoClientSettings.builder()

Selecione a aba Connection String ou MongoClientSettings para ver a sintaxe correspondente:

Inclua os seguintes parâmetros em sua string de conexão para habilitar a compressão:

Nome da opção
Tipo
Descrição

compressors

string

Especifica um ou mais algoritmos de compressão que o driver tentará usar para compactar as solicitações enviadas à instância conectada do MongoDB. Os valores possíveis incluem: zlib, snappy e zstd.

Padrão: null

zlibCompressionLevel

inteiro

Especifica o grau de compressão que zlib utiliza para diminuir o tamanho das solicitações para a instância MongoDB conectada. O nível pode variar de -1 a 9, com valores mais baixos sendo compactados mais rapidamente (mas resultando em solicitações maiores) e valores maiores compactando mais lentamente (mas resultando em solicitações menores).

Padrão: null

Especifica a seguir a ordem em que o driver tentará compactar as solicitações antes de serem enviadas:

ConnectionString connectionString = new ConnectionString( "mongodb+srv://<db_username>:<db_password>@<cluster-url>/?compressors=snappy,zlib,zstd"); MongoClient client = MongoClients.create(connectionString);

Para obter mais informações sobre esses parâmetros, consulte a documentação da API ConnectionString.

Para saber mais sobre qualquer um dos métodos ou tipos discutidos neste guia, consulte a seguinte documentação da API: