샤드 클러스터에서 장기 실행 보조 읽기

모니터링

다음과 같은 방법으로 고아 정리로 인해 종료된 세컨더리 읽기를 모니터 할 수 있습니다.

• 다음 명령을 mongosh 사용하여 세컨더리 노드 의 서버 상태를 확인합니다.

  db.serverStatus().metrics.operation.killedDueToRangeDeletion

• mongod 로그를 검토합니다. 종료될 때마다 다음 예시 와 같은 로그 항목이 생성됩니다.

{
   "t": {
         "$date": "2025-06-11T12:11:43.361+02:00"
   },
   "s": "I",
   "c": "SHARDING",
   "id": 10016300,
   "svc": "S",
   "ctx": "conn93",
   "msg": "Read has been terminated due to orphan range cleanup",
   "attr": {
         "type": "command",
         ...
         "workingMillis": 0,
         "durationMillis": 0,
         "orphanCleanupDelaySecs": 3600
   }
}

재개 메커니즘 구현

재개 메커니즘을 사용하면 애플리케이션 이전 읽기 작업이 종료되는 지점에서 시작되는 새 읽기 작업을 생성할 수 있습니다.

효과적인 재개 메커니즘을 구현 하려면 애플리케이션 쿼리 결과에 대해 일관적인 정렬 순서를 사용해야 합니다. 이력서 메커니즘의 정렬 순서를 선택할 때 다음 요소를 고려하세요.

• 효율적인 쿼리 실행을 위해 정렬 작업은 인덱싱된 필드 활용해야 합니다.

• 정렬 필드 에는 고유한 값이 포함되어야 합니다.

  • 정렬 필드 값이 고유하지 않은 경우 애플리케이션 동일한 정렬 값을 주식 문서를 처리하다 위해 추가 로직을 구현 해야 합니다.

{
        "state": "NY",
        "city": "NEW YORK",
        "zipcode": "00501"
}

let readDoc;
let latestZip;
let cursor = db.getSiblingDB("cities").zipcodes.find({
   state: "NY"
})
.sort({zipcode: 1})
.readPref("secondary");
while(cursor.hasNext()) {
   try {
      readDoc = cursor.next();
      // process `readDoc` here
      latestZip = readDoc.zipcode;
   } catch (err) {
      if (err.code === 175 &&
         err.errmsg.includes("Read has been terminated due to orphan range cleanup")) {
         console.log("Query terminated, resuming from zipcode:", latestZip);
         cursor = db.getSiblingDB("cities").zipcodes.find({
               state: "NY",
               zipcode: {$gt: latestZip}
         })
         .sort({zipcode: 1})
         .readPref("secondary");
      } else {
         throw err; // Rethrow non-termination errors
      }
   }
}

{
   code: 175,
   name: QueryPlanKilled,
   categories: [CursorInvalidatedError],
   errmsg: "Read has been terminated due to orphan range cleanup"
}

orphanCleanupDelaySecs 증가

서버 매개변수는 소스 샤드 에서 마이그레이션된 청크 삭제하기 전에 MongoDB 대기하는 orphanCleanupDelaySecs 시간을 제어합니다.

orphanCleanupDelaySecs 를 늘리면 세컨더리 읽기 작업을 더 오랜 시간 동안 실행 수 있습니다. 스타트업 과 런타임 모두에 orphanCleanupDelaySecs 를 설정하다 수 있습니다.

다음 명령은 orphanCleanupDelaySecs 시간을 2 시간으로 설정합니다.

db.adminCommand({
        setParameter: 1,
        orphanCleanupDelaySecs: 7200
})

세컨더리 읽기 종료 비활성화

terminateSecondaryReadsOnOrphanCleanup 서버 매개 변수는 고아 문서 삭제되기 전에 장기 세컨더리 읽기를 자동으로 종료할지 여부를 제어합니다.

terminateSecondaryReadsOnOrphanCleanup 를 false로 설정하여 세컨더리 읽기 종료를 비활성화할 수 있습니다. 이 매개변수는 스타트업 또는 런타임에 설정하다 수 있습니다.

다음 명령은 terminateSecondaryReadsOnOrphanCleanup 를 false로 설정합니다.

db.adminCommand({
        setParameter: 1,
        terminateSecondaryReadsOnOrphanCleanup: false
})

밸런서 비활성화

밸런서 비활성화하고 수동 마이그레이션을 수행하지 않으면 장기 실행 세컨더리 읽기가 자동으로 종료되는 것을 방지할 수 있습니다.

특정 컬렉션에 대한 밸런서 비활성화하려면 configureCollectionBalancing 명령의 enableBalancing 필드 사용합니다.

밸런서 작업을 특정 시간으로 제한하려면 밸런싱 기간 예약을 참조하세요.