$listSessions (집계 단계)

정의

$listSessions

config 데이터베이스의 system.sessions collection에 저장된 모든 세션을 나열합니다. 이러한 세션은 MongoDB deployment의 모든 구성원이 볼 수 있습니다.

중요

When a user creates a session on a mongod or mongos instance, the record of the session initially exists only in-memory on the instance; i.e. the record is local to the instance. Periodically, the instance will sync its cached sessions to the system.sessions collection in the config database, at which time, they are visible to $listSessions and all members of the deployment. Until the session record exists in the system.sessions collection, you can only list the session via the $listLocalSessions operation.

To run $listSessions, it must be the first stage in the pipeline.

이 단계에는 다음 구문이 있습니다.

{ $listSessions: <document> }

The $listSessions stage takes a document with one of the following contents:

필드	설명
{ }	액세스 제어와 함께 실행하는 경우 현재 인증된 사용자에 대한 모든 세션을 반환합니다. 액세스 제어 없이 실행하는 경우 모든 세션을 반환합니다.
{ users: [ { user: <user>, db: <db> }, ... ] }	지정된 사용자에 대한 모든 세션을 반환합니다. 액세스 제어와 함께 실행하는 경우 인증된 사용자는 cluster에서 listSessions 조치가 있는 권한이 있어야 다른 사용자의 세션을 나열할 수 있습니다.
{ allUsers: true }	모든 사용자에 대한 모든 세션을 반환합니다. 액세스 제어와 함께 실행하는 경우 인증된 사용자는 클러스터에서 listSessions 작업이 있는 권한이 있어야 합니다.

제한 사항

$listSessions 은(는) 거래에서 허용되지 않습니다.

예시

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

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

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

const db = client.db("config");
const collection = db.collection("system.sessions");
const pipeline = [{ $listSessions: { allUsers: true } }];
const cursor = collection.aggregate(pipeline);
return cursor;

const db = client.db("config");
const collection = db.collection("system.sessions");
const pipeline = [
  { 
    $listSessions: { 
      users: [{ user: "myAppReader", db: "test"}] 
    } 
  }
];
const cursor = collection.aggregate(pipeline);
return cursor;

const db = client.db("config");
const collection = db.collection("system.sessions");
const pipeline = [{ $listSessions: {} }];
const cursor = collection.aggregate(pipeline);
return cursor;

출력

$listSessions 세션당 하나의 문서가 포함된 커서를 반환합니다. 각 문서에는 다음 프로토타입이 있습니다.

{
   _id: {
      id: <UUID>,
      uid: <BinData>
   },
   lastUse: <date>
}