cursor.maxTimeMS()

세션 유휴 시간 제한 재정의 maxTimeMS

MongoDB 드라이버와 mongosh 는 승인되지 않은 쓰기 작업을 제외한 모든 작업을 서버 세션 과 연결합니다. 세션과 명시적으로 연결되지 않은 작업(예: Mongo.startSession() 사용)의 경우, MongoDB 드라이버와 mongosh 는 암시적 세션을 생성하여 작업과 연결합니다.

세션이 30 분 이상 유휴 상태인 경우 MongoDB 서버는 해당 세션을 만료된 것으로 표시하고 언제든지 세션을 닫을 수 있습니다. MongoDB 서버가 세션을 닫으면 진행 중인 모든 작업과 세션과 관련된 열린 커서도 종료됩니다. 여기에는 noCursorTimeout() 또는 30 분보다 큰 maxTimeMS() 로 구성된 커서가 포함됩니다.

예를 들어 maxTimeMS() 가 31 분의 시간 제한으로 구성된 find() 작업을 생각해 보겠습니다. 서버는 find() 의 cursor.batchSize() 에 의해 정의된 문서 배치와 함께 커서를 반환합니다. 애플리케이션이 서버에서 새 문서 배치를 요청할 때마다 세션이 새로 고쳐집니다. 그러나 애플리케이션이 현재 문서 배치를 처리하는 데 30 분 이상 소요되면 세션이 만료로 표시되고 닫힙니다. 서버가 세션을 닫으면 커서도 30 분보다 큰 maxTimeMS() }분으로 구성되어 있음에도 불구하고 종료됩니다. 애플리케이션이 다음 문서 배치를 요청하면 서버는 오류를 반환합니다.

커서를 반환하는 작업의 경우 커서가 30분 이상 유휴 상태일 수 있는 경우 Mongo.startSession()를 사용하여 명시적 세션 내에서 작업을 실행하고 refreshSessions 명령을 사용하여 세션을 주기적으로 새로 고칩니다. 예를 들면 다음과 같습니다.

var session = db.getMongo().startSession()
var sessionId = session
sessionId  // show the sessionId
var cursor = session.getDatabase("examples").getCollection("data").find().noCursorTimeout()
var refreshTimestamp = new Date() // take note of time at operation start
while (cursor.hasNext()) {
  // Check if more than 5 minutes have passed since the last refresh
  if ( (new Date()-refreshTimestamp)/1000 > 300 ) {
    print("refreshing session")
    db.adminCommand({"refreshSessions" : [sessionId]})
    refreshTimestamp = new Date()
  }
  // process cursor normally
}

예제 작업에서 db.collection.find() 메서드는 명시적 세션과 연결됩니다. 커서가 cursor.maxTimeMS() 로 구성되어 커서가 최소 31 분 동안 열린 상태로 유지됩니다. while 루프에는 refreshSessions 를 사용하여 5 분마다 세션을 새로 고치는 차단이 포함되어 있습니다. 세션이 30 분의 유휴 시간 제한을 초과하지 않으므로 커서는 구성된 maxTimeMS() 까지 열린 상태로 유지될 수 있습니다.

MongoDB 드라이버의 경우 세션 생성에 대한 지침 및 구문은 드라이버 설명서 를 참조하세요.