AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

ネットワーク トラフィックを圧縮

MongoDBドライバーは、 MongoDB Serverとの間で送受信されるメッセージを圧縮できます。これにより、各操作で転送されるデータ量が減ります。圧縮により、制約されたネットワークのパフォーマンスが向上し、 MongoDB Atlas の実行中に関連するデータ転送コストが削減されます。

圧縮はワイヤプロトコルレベルで動作するため、アプリケーションが実行するすべての操作に適用されます。複数のアルゴリズムを指定した場合 、ドライバーはMongoDB Serverもサポートしているリスト内の最初のアルゴリズムを使用します。

MongoDBドライバーは次の圧縮アルゴリズムをサポートしています。

MongoDB Atlas は、クラウドリージョン、クラウドプロバイダー、および インフラストラクチャとMongoDB Atlas間で転送されたデータに対して料金を請求します。ネットワーク圧縮により、アプリケーションが送受信するデータ量が減り、これらのデータ転送コストを削減できます。価格の詳細については、「 データ転送コスト 」を参照してください。

ネットワーク圧縮には、効率的な利点も得られます。圧縮されたメッセージはネットワーク間での転送時間が短縮されるため、アプリケーションの応答時間を向上させることができます。圧縮により、 MongoDBトラフィックが使用する帯域幅も削減されるため、同じネットワーク上の他のアプリケーションで使用できる帯域幅が増えます。

圧縮アルゴリズムを選択する場合は、次のガイドラインを考慮してください。

  • 圧縮効率とリソース使用量のバランスを取るには、Zstandard を使用します。 Zstandard は、ほとんどのアプリケーションでのデフォルトの選択に適しています。

  • 最小限の計算オーバーヘッドを必要とするレイテンシの影響を受けやすいアプリケーションには、 Snappy を使用してください。

  • MongoDBドライバーと環境間での広範な互換性を実現するには、Zlib を使用してください。

Tip

CPU 使用率の監視

圧縮により、ネットワーク帯域幅とCPU使用量のトレードオフが発生します。ネットワーク圧縮を有効にした後は、トレードオフがワークロードにメリットがあることを確認するため、アプリケーションのCPU使用率をモニターします。これらのトレードオフの詳細については、CPU Utilization and Network 圧縮 in MongoDB ブログ記事を参照してください。

Kotlin Syncドライバーのすべてのバージョンは、Snappy、Zlib、および Zstandard 圧縮をサポートしています。

次の表は、各アルゴリズムでサポートされる最小のMongoDB Serverバージョンを示しています。

圧縮アルゴリズム
サーバーの最小バージョン

4.2

4.2

4.2

MongoDB接続のネットワーク圧縮を有効にするには、必要な依存関係をインストールし、使用する圧縮アルゴリズムを指定します。

次の表は、各アルゴリズムと、必要な依存関係(存在する場合)を示しています。

圧縮アルゴリズム
依存

Snappy

snappy-javaSnappy ライブラリ用のJava JNIラッパーである をダウンロードします。をインストールするには、Maven Central の snappy-java を参照してください。

Zlib

なし。ドライバーは Zlib 圧縮をネイティブでサポートしています。

Zstandard

Zstandard ライブラリ用の Java JNI ラッパーである zstd-jni をダウンロードする。インストールするには、Maven Central の zstd-jni を参照してください。

次のいずれかの方法でアルゴリズムを指定することで、 MongoDBインスタンスへの接続の圧縮を有効にできます。

  • compressorList() メソッドを MongoClientSettings.builder() メソッドにチェーンします。

  • 接続 URI で compressors パラメータを使用します。

次の例は、 MongoDB .に接続するときに、利用可能なすべてのコンプレッサーを指定する方法を示しています。対応する構文を確認するには、MongoClientSettings タブまたは Connection URIタブを選択します。

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)

圧縮アルゴリズムの 1 つとして Zlib を指定する場合は、MongoCompressor.LEVELプロパティを使用して圧縮レベルを指定することもできます。このオプションは、-1 から 9 までの整数値を受け入れます。

  • -1: デフォルトの圧縮(通常は 6)

  • 0: 圧縮なし

  • 1: 速度は最も速く、圧縮は最小

  • 9: 圧縮に最適ですが、速度は最も遅くなります

次の例は、zlib コンプレッサーの圧縮レベルを指定する方法を示しています。対応する構文を確認するには、MongoClientSettings タブまたは Connection URIタブを選択します。

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)

このガイドで説明したメソッドや型の詳細については、次の API ドキュメントを参照してください。