定義
$listLocalSessionsバージョン 3.6 の新機能。
mongodまたはmongosインスタンスによってメモリにキャッシュされたセッションを一覧表示します。重要
ユーザーが
mongodまたはmongosインスタンスでセッションを作成すると、セッションのレコードは最初はインスタンスのメモリ内にのみ存在します。つまり、レコードは インスタンスに対してローカルです。 インスタンスはキャッシュされたセッションをconfigデータベースのsystem.sessionsコレクションに定期的に同期します。同期されると、$listSessionsと配置のすべてのノードにそのセッションが表示されます。 セッション レコードがsystem.sessionsコレクションに存在するまでは、$listLocalSessions操作によってのみセッションを一覧表示できます。$listLocalSessions操作では、db.aggregate()ではなく メソッドが使用されdb.collection.aggregate()。$listLocalSessionsを実行するには、パイプラインの最初のステージである必要があります。このステージの構文は、次のとおりです。
{ $listLocalSessions: <document> } $listLocalSessionsステージは、次のいずれかの内容を持つドキュメントを取得します。フィールド説明{ }アクセス制御を使用して実行している場合、 は現在認証されているユーザーのすべてのセッションを返します。
アクセス制御なしで実行している場合、 はすべてのセッションを返します。
{ users: [ { user: <user>, db: <db> }, ... ] }指定されたユーザーのすべてのセッションを返します。 アクセス制御を使用して実行中の場合、認証されたユーザーは、他のユーザーのセッションを一覧表示するには、クラスターに対して
listSessionsアクションの特権を持っている必要があります。{ allUsers: true }すべてのユーザーのすべてのセッションを返します。 アクセス制御を使用して実行している場合、認証されたユーザーにはクラスターでの
listSessionsアクション権限が必要です。
制限事項
$listLocalSessions トランザクションでは許可されていません。
例
すべてのローカル セッションを一覧表示
接続されたmongod / mongosインスタンスのメモリ内セッション キャッシュから、次の集計操作はすべてのセッションを一覧表示します。
注意
アクセス制御を使用して実行中の場合、現在のユーザーにはクラスターに対するlistSessionsアクションの特権が必要です。
db.aggregate( [ { $listLocalSessions: { allUsers: true } } ] )
指定されたユーザーのすべてのローカル セッションを一覧表示
接続されたmongod / mongosインスタンスのメモリ内キャッシュから、次の集計操作を実行すると、指定されたユーザーmyAppReader@testのすべてのセッションが一覧表示されます。
注意
アクセス制御を使用して実行中で、現在のユーザーが指定されたユーザーでない場合、現在のユーザーにはクラスターに対するlistSessionsアクションの権限が必要です。
db.aggregate( [ { $listLocalSessions: { users: [ { user: "myAppReader", db: "test" } ] } } ] )
現在のユーザーのすべてのローカル セッションを一覧表示する
接続されたmongod / mongosインスタンスのメモリ内キャッシュから、次の集計操作は、アクセス制御を使用して実行された場合、現在のユーザーのすべてのセッションを一覧表示します。
db.aggregate( [ { $listLocalSessions: { } } ] )
アクセス制御なしで実行すると、操作にはすべてのローカル セッションが一覧表示されます。