接続プール

項目一覧

Overview
接続プールの構成
詳細情報
API ドキュメント

Overview

このガイドでは、 PyMongo が接続プールを使用してMongoDBデプロイへの接続を管理する方法と、アプリケーションで接続プール設定を構成する方法について学習できます。

接続プールとはオープンデータベース接続のキャッシュであり、 PyMongoによって維持されます。アプリケーションがMongoDBへの接続を要求すると、 PyMongo はプールからシームレスに接続を取得し、操作を実行し、再利用するためにプールに接続を返します。

接続プールは、アプリケーションのレイテンシと新しい接続がPyMongoによって作成される回数を削減するのに役立ちます。

接続プールの構成

次の接続プール設定は、MongoClientオブジェクトまたは接続 URI で指定できます。

設定	説明
`connectTimeoutMS`	The time that PyMongo waits when establishing a new connection before timing out. Data Type: `int` Default: `20000` MongoClient Example: `connectTimeoutMS = 40000` Connection URI Example: `connectTimeoutMS=40000`
`maxConnecting`	The maximum number of connections that each pool can establish concurrently. If this limit is reached, further requests wait until a connection is established or another in-use connection is checked back into the pool. Data Type: `int` Default: `2` MongoClient Example: `maxConnecting = 3` Connection URI Example: `maxConnecting=3`
`maxIdleTimeMS`	The maximum time that a connection can remain idle in the pool. When a connection exceeds this limit, PyMongo closes the connection and removes it from the pool. Data Type: `int` Default: `None` (no limit) MongoClient Example: `maxIdleTimeMS = 60000` Connection URI Example: `maxIdleTimeMS=60000`
`maxPoolSize`	The maximum number of concurrent connections that the pool maintains. If the maximum pool size is reached, further requests wait until a connection becomes available. Data Type: `int` Default: `100` MongoClient Example: `maxPoolSize = 150` Connection URI Example: `maxPoolSize=150`
`minPoolSize`	The minimum number of concurrent connections that the pool maintains. If the number of open connections falls below this value due to network errors, PyMongo attempts to create new connections to maintain this minimum. Data Type: `int` Default: `0` MongoClient Example: `minPoolSize = 3` Connection URI Example: `minPoolSize=3`
`socketTimeoutMS`	The length of time that PyMongo waits for a response from the server before timing out. Data Type: `int` Default: `None` (no timeout) MongoClient Example: `socketTimeoutMS = 100000` Connection URI Example: `socketTimeoutMS=100000`
`waitQueueTimeoutMS`	How long a thread waits for a connection to become available in the connection pool before timing out. Data Type: `int` Default: `None` (no timeout) MongoClient Example: `waitQueueTimeoutMS = 100000` Connection URI Example: `waitQueueTimeoutMS=100000`

次のコードでは、maxPoolSize パラメータを使用して最大接続プールサイズが 50 のクライアントを作成します。

client = MongoClient(host, port, maxPoolSize=50)

次のコードでは、前の例と同じ構成のクライアントを作成しますが、接続 URI を使用します。

client = MongoClient("mongodb://<host>:<port>/?maxPoolSize=50")

詳細情報

接続プールの詳細については、 MongoDB Serverマニュアルの「接続プールの概要」を参照してください。

API ドキュメント

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

MongoClient

戻る

MongoDB Server実行時間の制限

データベースとコレクション