Docs Menu
Docs Home
/
MongoDBマニュアル
/
参照
/
演算子
/
集計パイプライン ステージ

$listSessions

項目一覧

  • 定義
  • 制限事項
  • 例

定義

$listSessions

バージョン 3.6 の新機能。

configデータベース内の system.sessionsコレクションに保存されているすべてのセッションを一覧表示します。 これらのセッションは、MongoDB 配置のすべてのノードに表示されます。

重要

ユーザーがmongodまたはmongosインスタンスでセッションを作成すると、セッションのレコードは最初はインスタンスのメモリ内にのみ存在します。つまり、レコードは インスタンスに対してローカルです。 インスタンスはキャッシュされたセッションをconfigデータベースのsystem.sessionsコレクションに定期的に同期します。同期されると、 $listSessionsと配置のすべてのノードに表示されます。 セッション レコードがsystem.sessionsコレクションに存在するまでは、 $listLocalSessions操作によってのみセッションを一覧表示できます。

$listSessionsを実行するには、パイプラインの最初のステージである必要があります。

このステージの構文は、次のとおりです。

{ $listSessions: <document> }

$listSessionsステージは、次のいずれかの内容を持つドキュメントを取得します。

フィールド
説明
{ }

アクセス制御を使用して実行している場合、 は現在認証されているユーザーのすべてのセッションを返します。

アクセス制御なしで実行している場合、 はすべてのセッションを返します。

{ users: [ { user: <user>, db: <db> }, ... ] }
指定されたユーザーのすべてのセッションを返します。 アクセス制御を使用して実行中の場合、認証されたユーザーは、他のユーザーのセッションを一覧表示するには、クラスターに対してlistSessionsアクションの特権を持っている必要があります。
{ allUsers: true }
すべてのユーザーのすべてのセッションを返します。 アクセス制御を使用して実行している場合、認証されたユーザーにはクラスターでのlistSessionsアクション権限が必要です。

制限事項

$listSessions トランザクションでは許可されていません。

例

すべてのセッションを一覧表示

system.sessionsコレクションから、次の集計操作はすべてのセッションを一覧表示します。

注意

アクセス制御を使用して実行中の場合、現在のユーザーにはクラスターに対するlistSessionsアクションの特権が必要です。

use config
db.system.sessions.aggregate( [  { $listSessions: { allUsers: true } } ] )

指定されたユーザーのすべてのセッションを一覧表示

次の集計操作では、 system.sessionsコレクションから、指定されたユーザーmyAppReader@testのすべてのセッションが一覧表示されます。

注意

アクセス制御を使用して実行中で、現在のユーザーが指定されたユーザーでない場合、現在のユーザーにはクラスターに対するlistSessionsアクションの権限が必要です。

use config
db.system.sessions.aggregate( [ { $listSessions: { users: [ {user: "myAppReader", db: "test" } ] } } ] )

現在のユーザーのすべてのセッションを一覧表示

system.sessionsコレクションから、次の集計操作は、アクセス制御を使用して実行された場合、現在のユーザーのすべてのセッションを一覧表示します。

use config
db.system.sessions.aggregate( [ { $listSessions: { } } ] )

アクセス制御なしで実行すると、操作はすべてのセッションを一覧表示します。

戻る

$listLocalSessions

次へ

$lookup