网络压缩

概述

在本指南中，您可以学习如何使用Rust驱动程序配置您的MongoDB连接的网络压缩。

网络压缩是一种功能，允许您压缩和解压缩应用程序与MongoDB之间发送的消息，从而减少通过网络传输的总数据量。

驱动程序支持以下压缩器

1. Snappy：MongoDB 3.4及以后版本可用

2. Zlib：MongoDB 3.6及以后版本可用

3. Zstandard：从MongoDB 4.2版本开始支持

本指南包括以下部分

• 添加压缩功能标志描述了如何为不同的压缩程序添加功能标志到您的应用程序

• 启用网络压缩描述了如何在您的客户端实例上启用网络压缩

• 更多信息提供了本指南中提到的类型和方法的相关资源和API文档链接

添加压缩功能标志

要使用压缩程序，请将相关的功能标志添加到您的项目中的Cargo.toml文件中，以添加到mongodb依赖项的功能列表。

选择您首选压缩程序的选项卡，以了解如何将必要功能标志添加到您的mongodb依赖项

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

[dependencies.mongodb]
version = "3.1.0"
features = ["zlib-compression"]

[dependencies.mongodb]
version = "3.1.0"
features = ["zstd-compression"]

启用网络压缩

您可以通过指定压缩程序以以下方式在您的 客户端 实例上启用压缩：

• 将 compressors 参数添加到您的连接字符串中。要查看通过这种方式启用压缩的示例，请参阅 连接字符串 部分。

• 设置 ClientOptions 实例的 compressors 字段。然后您可以在创建 Client 时将选项传递给 with_options() 方法。要查看通过这种方式启用压缩的示例，请参阅 ClientOptions 部分。

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

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)?;

更多信息

有关本指南中概念更多信息，请参阅以下文档

• 连接指南

• 服务器手册中的连接字符串压缩选项

• 所有 Rust 驱动功能标志