Overview
En esta guía, aprenderá a usar el controlador Kotlin Sync para habilitar la compresión de red. El controlador ofrece una opción de conexión para comprimir mensajes, lo que reduce la cantidad de datos que se transfieren por la red entre MongoDB y su aplicación.
El controlador admite los siguientes algoritmos de compresión:
Si especifica varios algoritmos de compresión, el controlador selecciona el primero de la lista compatible con su instancia de MongoDB.
Nota
Las aplicaciones que requieren compresión Snappy o Zstandard deben agregar dependencias explícitas para dichos algoritmos. Para obtener más información, consulte la sección "Dependencias de los algoritmos de compresión" de esta guía.
Especificar algoritmos de compresión
Puedes habilitar la compresión para la conexión a tu instancia de MongoDB al especificar los algoritmos de una de las siguientes formas:
Encadenar el
compressorList()método al métodoMongoClientSettings.builder().Utilice el parámetro
compressorsen su URI de conexión.
Los siguientes ejemplos demuestran cómo especificar todos los compresores disponibles al conectarse a MongoDB. Seleccione el MongoClientSettings o la pestaña Connection URI para ver la sintaxis correspondiente:
val settings = MongoClientSettings.builder() .applyConnectionString(ConnectionString("<connection string>")) .compressorList( listOf( MongoCompressor.createSnappyCompressor(), MongoCompressor.createZlibCompressor(), MongoCompressor.createZstdCompressor()) ) .build() val mongoClient = MongoClient.create(settings)
val uri = ConnectionString("mongodb+srv://<db_username>:<db_password>@<cluster-url>/?compressors=snappy,zlib,zstd") val mongoClient = MongoClient.create(uri)
Especifique el nivel de compresión Zlib
Si especifica zlib como uno de sus algoritmos de compresión, también puede usar la propiedad MongoCompressor.LEVEL para especificar un nivel de compresión. Esta opción acepta un valor entero entre -1 y 9:
-:1 Compresión predeterminada
6(normalmente)0: Sin compresión
1: Velocidad más rápida pero compresión más baja
9: Mejor compresión pero menor velocidad
Los siguientes ejemplos muestran cómo especificar un nivel de compresión para el compresor zlib. Seleccione la pestaña MongoClientSettings o Connection URI para ver la sintaxis correspondiente:
val zlib = MongoCompressor.createZlibCompressor() val settings = MongoClientSettings.builder() .applyConnectionString(ConnectionString(uri)) .compressorList(listOf(zlib.withProperty(MongoCompressor.LEVEL, <level>))) .build() val mongoClient = MongoClient.create(settings)
val uri = "mongodb://<db_username>:<db_password>@<hostname>:<port>/?" + "compressors=zlib" + "zlibCompressionLevel=<zlib compression level>" val mongoClient = MongoClient.create(uri)
Dependencias del algoritmo de compresión
El JDK admite de forma nativa la compresión Zlib. Sin embargo, Snappy y Zstandard dependen de implementaciones de Java de código abierto. Para obtener más información sobre estas implementaciones, consulte los siguientes repositorios de GitHub:
Documentación de la API
Para aprender más sobre cualquiera de los métodos o tipos analizados en esta guía, consulta la siguiente documentación de API: