Docs Menu
Docs Home
/
MongoDBマニュアル
/ / /

startSession

項目一覧

  • 定義
  • 互換性
  • 構文
  • 動作
  • 出力
startSession

startSessionコマンドは、一連の操作に対して新しい論理セッションを開始します。

Tip

mongoshでは、このコマンドはMongo.startSession()ヘルパー メソッドを通じて実行することもできます。

ヘルパー メソッドはmongoshユーザーには便利ですが、データベースコマンドと同じレベルの情報は返されない可能性があります。 便宜上必要ない場合、または追加の戻りフィールドが必要な場合は、 データベースコマンドを使用します。

このコマンドは、次の環境でホストされている配置で使用できます。

  • MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

注意

このコマンドは、すべてのMongoDB Atlasクラスターでサポートされています。すべてのコマンドの Atlas サポートの詳細については、「 サポートされていないコマンド 」を参照してください。

  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

このコマンドの構文は、次のとおりです。

db.runCommand(
{
startSession: 1
}
)

startSessionを実行するには、 db.runCommand( { <command> } )メソッドを使用します。

db.runCommand(
{
startSession: 1
}
)

重要

featureCompatibilityVersion は3.6である必要があります または より大きい場合は、 startSessionコマンドを使用します。

Tip

以下も参照してください。

配置で認証/承認が強制される場合、 startSessionコマンドを実行するには認証が必要です。 作成されたセッションはstartSessionを実行するユーザーが所有し、そのユーザーのみがセッションを使用できます。

配置で認証/認可が強制されない場合、作成されたセッションには所有者がなく、任意の接続で任意のユーザーが使用できます。 ユーザーが認証を行い、認証/認可を強制しない配置のセッションを作成した場合、セッションはユーザーが所有します。 ただし、あらゆる接続上のどのユーザーもセッションを使用できます。

配置がダウンタイムなしで認証に移行すると、所有者のいないセッションは使用できなくなります。

セッションは、セッションを作成したMongoClientオブジェクトでのみ使用できます。 1 つのセッションを同時に使用することはできません。 1 つのセッションを使用する操作は連続して実行する必要があります。

コマンドのステータスとoptimeに加えて、 startSessionは次のセッション固有の情報を返します。

フィールド
タイプ
説明
id
ドキュメント

セッションの識別子の 16 バイトの UUID(汎用一意識別子)部分を含むドキュメント。

id: { id: <UUID> }

セッションの識別子は、この UUID と認証されたユーザー認証情報のハッシュを連結したもので構成されています。

timeoutMinutes
数値

クライアントが最後に使用してから、期限切れになる前にセッションがアクティブな状態であった時間(分単位)。 デフォルトでは、セッションの有効期限は 30 分です。 この値を変更するには、 の起動時にlocalLogicalSessionTimeoutMinutes パラメータを設定しますmongodレプリカセットとシャーディングされたクラスターの場合、すべてのノードに同じ 値を指定する必要があります。

戻る

refreshSessions