サーバーセッション

項目一覧

MongoDB5.0 は 10 月2024 をもってサポートを終了します。このバージョンのドキュメントはサポート対象外になりました。配置をアップグレードするには、 MongoDB を参照してください。5.0 60アップグレード手順。

バージョン 3.6 の新機能。

Overview

アプリケーションはクライアントセッションをサーバーセッションとのインターフェイスとして使用します。

サーバー　セッションはレプリカセットとシャーディングされたクラスターでのみ利用可能です。

3.6 以降、MongoDB ドライバーは、未確認の書き込みを除くすべての操作をサーバーセッションに関連付けます。サーバー　セッションとの関連付けをサポートするために、すべてのコマンドで次のオプションを使用できます。

mongosh ドライバーはこれらのオプションをセッション内のコマンドに割り当てます。

オプション	タイプ	説明
`lsid`	ドキュメント	コマンドに関連付けられたセッションの一意の ID を指定するドキュメント。`txnNumber` を指定する場合は、`lsid` が必要です。
`txnNumber`	64 ビット整数	コマンドのセッション内でコマンドを一意に識別する、厳密に増加する非負の数値。指定する場合、コマンドには `lsid` オプションも含める必要があります。

ステートメントの配列を受け取る delete 、 insert 、およびupdate コマンドでは、次のオプションも使用できます。

stmtIds を手動で設定しないでください。MongoDB は stmtIds を厳密に増加する非負の数に設定します。

オプション	タイプ	説明
`stmtIds`	32 ビット整数の配列	書込み (write) コマンド内のそれぞれの書き込み操作を一意に識別する数値の配列。

次のコマンドを使用して、MongoDB クラスター全体のサーバーセッションを一覧表示、管理、および強制終了できます。

コマンド	説明
`endSessions`	指定したサーバーセッションを期限切れにします。
`killAllSessions`	すべてのサーバーセッションを強制終了します。
`killAllSessionsByPattern`	指定されたパターンに一致するすべてのサーバーセッションを終了します。
`killSessions`	指定したサーバーセッションを強制終了します。
`refreshSessions`	アイドル状態のサーバーセッションを更新します。
`startSession`	新しいサーバーセッションを開始します。

配置で認証/承認が強制される場合、セッションを開始するにはユーザーを認証する必要があり、そのユーザーのみがセッションを使用できます。

$external認証ユーザー（Kerberos、LDAP、または x.509 ユーザー）でクライアントセッションと因果整合性の保証を使用するには、ユーザー名を 10k バイトより大きくすることはできません。

配置で認証/承認が強制されない場合、作成されたセッションには所有者が存在せず、どの接続でも任意のユーザーが使用できます。ユーザーが認証を行い、認証/承認を強制しない配置のセッションを作成した場合、そのユーザーがセッションを所有します。しかし、任意の接続の任意のユーザーがセッションを使用できます。

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

戻る

$natural

Stable API