Overview
MongoDB 配置に接続するには、次の 2 つのものが必要です。
接続 URI （接続文字列とも呼ばれます）で、接続するMongoDBデプロイをKotlinドライバーに指示します。
MongoDB 配置への接続を作成し、それに対して操作を実行できるようにするMongoClientオブジェクト。
これらのコンポーネントのいずれかを使用して、 MongoDB .に接続中にKotlinドライバーの動作をカスタマイズすることもできます。
このガイドでは、接続string を作成し、{0MongoClient オブジェクトを使用してMongoDB に接続する方法について説明します。
接続URI
接続 URI は、ドライバが MongoDB 配置に接続するための指示のセットを提供します。このセットで、ドライバーに MongoDB への接続方法と接続中の動作を指示します。次の図は、サンプル接続 URI の各部分について説明しています。
この図では、プロトコルに 標準接続文字列形式、mongodb を使用しています。配置の柔軟性を高め、クライアントを再構成せずにサーバーをローテーションで変更する能力が必要な場合は、DNS シード リスト接続形式、mongodb+srv を使用することもできます。
注意
MongoDB Atlasに配置している場合は、Atlas ドライバー接続ガイド Kotlinを参照し、言語ドロップダウンから {3 を選択して接続string を取得します。
パスワードベースの認証メカニズムを使用している場合、接続 URI の次の部分には認証情報が含まれます。 userの値をデータベースユーザー名に置き換え、 passの値をデータベースユーザーのパスワードに置き換えます。 認証メカニズムで認証情報が必要ない場合は、接続 URI のこの部分を省略します。
接続 URI の次の部分では、ホスト名または IP アドレスを指定し、その後に MongoDB インスタンスのポートを指定します。この例では、sample.host はホスト名を表し、27017 はポート番号を表します。これらの値を置き換えて、MongoDB インスタンスを参照します。
接続 URI の最後の部分には、パラメータとして接続オプションが含まれます。この例では、maxPoolSize=20 と の 2w=majority つの接続オプションを設定しています。接続オプションの詳細については、 接続オプションガイドをご覧ください。
MongoClient
MongoDBに接続して MongoDB と通信するには、 MongoClientクラスを使用します。
MongoClient を構築するには、MongoClient.create() メソッドを使用します。
次のコードは、MongoDBの配置に接続する MongoClient を作成する方法を示しています。
import com.mongodb.kotlin.client.coroutine.MongoClient val uri = "mongodb://localhost:27017/" val client = MongoClient.create(uri)
重要
クライアントの再利用
各 MongoClient はデータベースへのスレッドセーフな接続のプールを表すため、ほとんどのアプリケーションで必要なインスタンスは、複数のスレッド間でも、MongoClient の 1 つだけです。最大接続数などのすべてのリソース使用量の制限は、個々の MongoClient インスタンスに適用されます。
MongoClientの動作を制御するために使用できるさまざまな設定の詳細については、「 MongoClient 設定ガイド 」を参照してください。
Tip
インスタンスが不要になった場合は、常に MongoClient.close() を呼び出してリソースをクリーンアップします。
API ドキュメント
このセクションで説明されるメソッドとクラスの詳細については、次の API ドキュメントを参照してください。