cursor.maxTimeMS()

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

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

세션이 30분 이상 유휴 상태인 경우, MongoDB 서버는 해당 세션을 만료된 것으로 표시하고 언제든지 세션을 종료할 수 있습니다. MongoDB Server가 세션을 종료하면 진행 중인 모든 작업과 해당 세션과 관련된 열린 커서도 종료됩니다. 여기에는 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 드라이버의 경우, 세션 생성에 대한 지침과 구문은 드라이버 설명서를 참조하세요.

모든 작업에 대한 기본 시간 초과

MongoDB 8.0 부터는 개별 읽기 작업이 완료될 기본 시간 제한을 지정하기 위해 defaultMaxTimeMS 클러스터 매개변수를 사용할 수 있습니다 쿼리에서 maxTimeMS() 옵션을 지정하면 해당 값은 defaultMaxTimeMS 값을 재정의합니다.