MongoClient の作成
Overview
MongoDB 配置に接続するには、次の 2 つのものが必要です。
接続 URI （ 接続string とも呼ばれます）で、接続するPyMongo MongoDB配置を に指示します。
MongoDB 配置への接続を作成し、それに対して操作を実行できるようにするMongoClientオブジェクト。
また、これらのコンポーネントのいずれかを使用して、MongoDB に接続中の PyMongo の動作をカスタマイズすることもできます。
このガイドでは、接続string を作成し、{0MongoClient オブジェクトを使用してMongoDB に接続する方法について説明します。
接続URI
標準の接続stringには次のコンポーネントが含まれます。
コンポーネント | 説明 |
|---|---|
mongodb:// | 必須: これを標準接続形式の文字列として識別するプレフィックス。 |
username:password | 任意。 認証資格情報。 これらを含めると、クライアントは authSourceで指定されたデータベースに対してユーザーを認証します。 authSource接続オプションの詳細については、 認証メカニズム を参照してください。 |
host[:port] | 必須。 MongoDB が実行されているホストとオプションのポート番号。 ポート番号を指定しない場合、ドライバーはデフォルトのポート 27017を使用します。 |
/defaultauthdb | 任意。 接続stringに username:password@ 認証情報が含まれている一方で、authSource オプションが含まれていない場合に使用する認証データベース。 このコンポーネントを含めない場合、クライアントはadminデータベースに対してユーザーを認証します。 |
?<options> | 任意。 接続固有のオプションを <name>=<value> ペアとして指定するクエリstringです。 これらのオプションの詳細については、「接続オプションの指定 」を参照してください。 |
接続 の作成の詳細については、string MongoDB Serverドキュメントの「 接続 文字列 」を参照してください。
MongoClient
MongoDB への接続を作成するには、接続 URI を string としてMongoClientコンストラクターに渡します。 次の例では、ドライバーはサンプル接続 URI を使用して、 localhostのポート27017上の MongoDB インスタンスに接続します。
from pymongo import MongoClient uri = "mongodb://localhost:27017/" client = MongoClient(uri)
Tip
クライアントの再利用
各MongoClientオブジェクトはデータベースへの接続のプールを表すため、ほとんどのアプリケーションでは、複数のリクエスト間でもMongoClientのインスタンスが 1 つだけ必要になります。 ただし、プロセスをフォークする場合、子プロセスには独自のMongoClientオブジェクトが必要になります。 詳しくは、 FAQページをご覧ください。
API ドキュメント
PyMongo でMongoClientオブジェクトを作成する方法の詳細については、次の API ドキュメントを参照してください。