Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Comprimir el tráfico de la red

Los driver de MongoDB pueden comprimir los mensajes enviados y recibidos de MongoDB Server. Esto reduce la cantidad de transferencia de datos para cada operación. La compresión puede mejorar el rendimiento en redes restringidas y reducir los costos de transferencia de datos asociados con la ejecución de MongoDB Atlas.

La compresión funciona a nivel de protocolo de conexión, por lo que se aplica a cada operación que realiza su aplicación. Si especifica más de un algoritmo, el driver utiliza el primer algoritmo de su lista que MongoDB Server también admita.

Los drivers de MongoDB admiten los siguientes algoritmos de compresión:

MongoDB Atlas cobra por la transferencia de datos entre regiones de nube, proveedores de nube y entre su infraestructura y MongoDB Atlas. La compresión de red reduce la cantidad de datos que su aplicación envía y recibe, lo que puede reducir estos costos de transferencia de datos. Para aprender más sobre los precios, consulte Costos de transferencia de datos.

La compresión de red también tiene beneficios de productividad. Los mensajes comprimidos tardan menos tiempo en transferirse por la red, lo que puede mejorar los tiempos de respuesta de su aplicación. La compresión también reduce el ancho de banda que utiliza el tráfico de MongoDB, lo que deja más ancho de banda disponible para otras aplicaciones en la misma red.

Cuando elijas un algoritmo de compresión, considera las siguientes directrices:

  • Utilice Zstandard para lograr un equilibrio entre la eficiencia de compresión y el uso de recursos. Zstandard es una buena opción por defecto para la mayoría de las aplicaciones.

  • Utilice Snappy para aplicaciones sensibles a la latencia que requieren una sobrecarga computacional mínima.

  • Utilice zlib para una amplia compatibilidad en todos los drivers de MongoDB y entornos.

Tip

Supervisar el uso de la CPU

La compresión intercambia ancho de banda de red por uso de CPU. Después de habilitar la compresión de red, supervise la utilización de la CPU de su aplicación para confirmar que la compensación beneficia a su carga de trabajo. Para aprender más sobre estas compensaciones, consulte la entrada de blog sobre la utilización de la CPU y la compresión de red en MongoDB.

La siguiente tabla enumera la versión mínima de driver compatible y de MongoDB Server para cada algoritmo de compresión:

Algoritmo de compresión
Versión mínima del controlador
Versión mínima del servidor

2.1

4.2

2.1

4.2

2.1

4.2

Para usar un compresor, añade la bandera de característica relevante a la lista de funcionalidades de la dependencia mongodb en el archivo Cargo.toml del proyecto.

Seleccione la pestaña de su compresor preferido para ver cómo añadir el indicador de funcionalidad necesario a su dependencia mongodb:

[dependencies.mongodb]version = "3.10.0"features = ["snappy-compression"]

Tip

Para especificar múltiples compresores, debes agregar la funcionalidad de activación para cada compresor a tu dependencia mongodb.

Puede habilitar la compresión en su instancia Client especificando los compresores de las siguientes maneras:

  • Agregar el parámetro compressors a su cadena de conexión. Para ver un ejemplo que permite la compresión de esta manera, consulta la sección Cadena de conexión.

  • Configurar el campo compressors de una instancia ClientOptions. Después puedes pasar las opciones al método with_options() al instanciar un Client. Para ver un ejemplo que habilite la compresión de esta manera, consulta la sección ClientOptions.

Para habilitar la compresión mediante el uso de una cadena de conexión, especifique el parámetro compressors. Puede especificar uno o más de los siguientes valores para el parámetro compressors:

  • "snappy" para compresión Snappy

  • "zlib" para la compresión Zlib

  • "zstd" para la compresión Zstandard

El siguiente ejemplo muestra cómo especificar Snappy, Zlib y Zstandard como los compresores para una conexión:

let uri = "mongodb+srv://<db_username>:<db_password>@<cluster-url>/?compressors=snappy,zlib,zstd";let client = Client::with_uri_str(uri).await?;

Para obtener más información sobre cómo configurar las opciones del cliente, consulta la guía sobre Especificar opciones de conexión.

Para activar la compresión en tu instancia ClientOptions, configura el campo compressors y luego pasa las opciones al crear un cliente.

El campo compressors toma un valor del tipo Vec<Compressor>. El tipo Compressor tiene los siguientes valores posibles:

  • Compressor::Snappy

  • Compressor::Zstd { level: <integer> }

  • Compressor::Zlib { level: <integer> }

Para los compresores que tienen un campo level, ajuste el valor a None para indicar el nivel por defecto. La siguiente tabla describe los niveles de compresión por defecto y aceptados para Zlib y Zstandard:

Compresor
Nivel por defecto
Niveles aceptados

Zlib

6

Números enteros de 0 a 9 o None

Zstandard

3

Números enteros de 1 a 22 o None

Un valor level más alto resulta en una mayor compresión, que es más lenta.

El siguiente ejemplo muestra cómo especificar Snappy, Zlib y Zstandard como los compresores para una conexión:

let uri = "<connection string>";let mut client_options = ClientOptions::parse(uri).await?; let compressors = vec![ Compressor::Snappy, Compressor::Zstd { level: Some(1) }, Compressor::Zlib { level: None }]; client_options.compressors = Some(compressors);let client = Client::with_options(client_options)?;

Para más información sobre los conceptos de esta guía, consulta la siguiente documentación:

Para obtener más información sobre cualquiera de los métodos o tipos mencionados en esta guía, consulta la siguiente documentación API: