db.shutdownServer() (mongosh 메서드)

db.shutdownServer()

현재 mongod 또는 mongos 프로세스 깔끔하고 안전하게 종료합니다. 관리 데이터베이스 에 대해 작업을 db.shutdownServer()실행해야 합니다.

db.shutdownServer() 에는 다음 구문이 있습니다.

db.shutdownServer({
  force: <boolean>,
  timeoutSecs: <int>
})

이 메서드는 다음과 같은 필드를 사용합니다.

필드	설명
force	선택 사항. mongod 또는 mongos 강제로 종료하려면 true로 지정합니다. 강제 종료는 mongod 또는 mongos에서 진행 중인 모든 작업을 중단하며, 예기치 않은 동작을 초래할 수 있습니다. force을(를) 사용하여 진행 중인 인덱스 빌드를 일시 중지했다가 다시 시작할 수 있습니다. db.shutdownServer() 자세한 내용은 복제본 세트 멤버에 대한 를 참조하세요.
timeoutSecs	선택 사항. MongoDB 5.0부터 mongod 및 mongos는 종료하기 전에 진행 중인 모든 데이터베이스 작업이 완료될 수 있도록 정지 기간을 입력합니다. mongod 프라이머리가 종료 요청을 받으면 프라이머리는 다음을 수행합니다. 세컨더리로 단계를 낮추려고 시도합니다. 강등이 실패하는 경우 shutdown또는db.shutdownServer()명령이 실행 된 경우mongod는 강제 필드 true인 경우에만 종료 단계를 계속합니다. SIGTERM 신호가 mongod로 전송되고, mongod 는 항상 종료 단계를 계속합니다. 휴지기에 들어갑니다. 남은 모든 데이터베이스 작업을 종료합니다. 종료합니다. mongod 세컨더리 또는 mongos 종료 요청의 경우, 종료가 요청된 후 정지 기간이 입력됩니다. 정지 기간은 다음과 같이 지정됩니다. 또는 명령이 실행 된 shutdown db.shutdownServer() 경우timeoutSecs 필드 또는 shutdownTimeoutMillisForSignaledShutdown 서버 매개 변수(SIGTERM 신호가 mongod로 전송된 경우) 또는 SIGTERM 신호가 mongos로 전송된 경우 mongosShutdownTimeoutMillisForSignaledShutdown 서버 매개변수입니다. 클라이언트는 종료되는 mongod 또는 mongos에 대해 새 연결을 열 수 없습니다. timeoutSecs는 초 단위로 기간을 지정합니다. 기본값 과 같습니다. MongoDB 5.0에서 15초. MongoDB 5.0 이전 버전에서는 10초입니다. mongod 는 다음과 같이 timeoutSecs를 사용합니다. 현재 노드 복제본 세트 의 프라이머리 노드 인 경우mongod 는 프라이머리 노드 물러나기 전에 투표 선택 가능 노드 따라잡을 수 있도록 timeoutSecs 필드 에 지정된 시간(초)까지 기다립니다. 따라잡기 시간에 대한 자세한 내용은 복제 지연 참조하세요. 프라이머리 노드에서 물러난 후 현재 노드 상태 인 경우, 기존 작업을 완료할 SECONDARY 수 있는 정지 기간으로 timeoutSecs 에 지정된 나머지 시간을 사용합니다. 새 작업은 다른 복제본 세트 노드로 전송됩니다. MongoDB 부터 5.0 mongos 는 기존 작업을 완료할 수 있는 정지 기간으로 timeoutSecs를 사용합니다. 새 작업은 다른 노드로 mongos 전송됩니다. 5 이전의 MongoDB 버전에서.0, mongos 는 즉시 종료되며 timeoutSecs를 사용하지 않습니다. MongoDB 4.4 이하 버전에서 mongod 프라이머리 의 경우timeoutSecs는 세컨더리 따라잡을 때까지 프라이머리 기다려야 하는 시간(초)입니다. 지정된 시간 내에 세컨더리가 따라잡지 못하면 명령이 실패합니다. 기본값은 10 초입니다.

이 작업은 shutdown 명령 주위에 래퍼(wrapper)를 제공합니다.

db.getSiblingDB("admin").shutdownServer()

db.getSiblingDB("admin").shutdownServer({ "force" : true })

db.getSiblingDB("admin").shutdownServer({ "timeoutSecs": 60 })