replSetReconfig (데이터베이스 명령)

글로벌 쓰기 우려

You must explicitly set the global default write concern before attempting to reconfigure a replica set with a configuration that would change the implicit default write concern. To set the global default write concern, use the setDefaultRWConcern command.

term 복제본 구성 필드

The term field is set by the primary replica set member. The primary ignores the term field if set explicitly in the replSetReconfig operation.

재구성을 통해 한 번에 한 명 이하의 투표권 있는 멤버를 추가하거나 제거할 수 있습니다.

replSetReconfig by default allows adding or removing no more than 1 voting member at a time. For example, a new configuration can make at most one of the following changes to the cluster membership:

• 새 투표 복제본 세트 멤버 추가하기.

• 기존 투표 복제본 세트 구성원 제거하기.

• 기존 복제본 세트 구성원에 대한 votes 을 수정합니다.

To add or remove multiple voting members, issue a series of replSetReconfig operations to add or remove one member at a time.

강제 재구성을 실행하면 여러 명의 투표 멤버를 추가하거나 제거하더라도 새 구성이 즉시 설치됩니다. 강제 재구성으로 인해 "majority" 커밋된 쓰기 작업의 롤백 등 예기치 않은 동작이 발생할 수 있습니다.

재구성은 대다수의 구성원이 복제본 구성을 설치할 때까지 기다립니다.

replSetReconfig waits until a majority of voting replica set members install the new replica configuration before returning success. A voting member is any replica set member where members[n].votes is 1, including arbiters.

복제본 세트 멤버는 하트비트를 통해 복제본 구성을 전파합니다. 구성원이 version 및 term 이상의 구성을 알게 될 때마다 새 구성을 설치합니다. 재구성 프로세스에는 두 가지 뚜렷한 '대기' 단계가 있습니다:

1) 새 구성을 설치하기 전에 현재 구성이 커밋 될 때까지 기다립니다.

The "current" configuration refers to the replica configuration in use by the primary at the time replSetReconfig is issued.

구성이 커밋되는 시점은 다음과 같습니다:

• 대다수의 투표 복제 세트 구성원이 현재 구성을 설치했습니다 .

• 이전 구성에서 "majority"개 커밋된 모든 쓰기가 현재 구성의 과반수에도 복제되었습니다.

일반적으로 현재 구성은 대부분의 투표 복제 세트 구성원에 이미 설치되어 있습니다. 하지만 이전 구성에서 커밋된 쓰기 중 대다수가 현재 구성에서 모두 커밋되지는 않을 수 있습니다. Delayed { 2}명의 멤버 또는 lagging behind 명인 멤버는 이 단계에 소요되는 시간을 늘릴 수 있습니다.

최대 시간 제한이 있는 작업이 발행되었고 대기 중에 작업이 제한을 초과하는 경우 작업은 오류를 반환하고 새 구성을 삭제합니다. 한도는 누적되며 , 다음 단계로 진행된 후에도 재설정되지 않습니다.

2) 새 구성에서 투표 회원의 대다수가 새 구성을 설치할 때까지 기다립니다.

The "new" configuration refers to the replica configuration specified to replSetReconfig.

주 서버는 구성을 나머지 복제 세트 구성원으로 전파하기 전에 새 복제 구성을 설치하고 사용하기 시작합니다. 이 작업은 투표권을 가진 구성원 과반수가 새 구성을 설치할 때까지만 기다리며, 새 구성이 커밋될때까지 기다릴 필요가 없습니다.

최대 시간 제한이 있는 작업이 발행되었고 대기 중에 작업이 제한을 초과하는 경우, 작업은 오류를 반환하지만 새 구성을 계속 사용하고 전파합니다.

강제 재구성을 실행하면 이전 구성의 커밋 상태에 관계없이 새 구성이 즉시 설치됩니다. 강제 재구성으로 인해 "majority" 커밋된 쓰기 작업의 롤백 등 예기치 않은 동작이 발생할 수 있습니다.

현재 복제본 구성의 커미트먼트 상태를 확인하려면 replSetGetConfig 복제본 집합 기본에서 커미트먼트 상태 매개변수와 함께 를 실행합니다.

새 투표 복제본 세트 구성원에 대한 자동 재구성

MongoDB 5.0부터 새로 추가된 중고등학교는 투표 회원으로 간주되지 않으며 SECONDARY 주에 도달할 때까지 선출될 수 없습니다.

새 투표 노드 복제본 세트 에replSetReconfig 추가되면 newlyAdded 는 내부적으로 노드의 구성에 필드 추가합니다. 필드 가 있는 newlyAdded 노드는 현재 투표 노드 수에 포함되지 않습니다. 초기 동기화 완료되고 노드 SECONDARY 상태 newlyAdded 에 도달하면 필드 자동으로 제거됩니다.

액세스 제어

액세스 제어 를 적용하는 배포서버에서 명령을 실행하려면 사용자에게 cluster 리소스에 대한 replSetConfigure 권한 조치가 있어야 합니다. admin 데이터베이스에서 사용할 수 있는 clusterManager 기본 제공 역할은 이 명령에 필요한 권한을 제공합니다.

잠금 동작

replSetReconfig obtains a special mutually exclusive lock to prevent more than one replSetReconfig operation from occurring at the same time.

혼합 버전 복제본 세트

가용성

변경 사항이 제대로 전파되려면 세트 멤버 중 대다수가 작동해야 합니다.

replSetReconfig는 일부 상황에서 현재 프라이머리 강등되도록 트리거하다 할 수 있습니다. 프라이머리가 강등되면 새로운 프라이머리 선택하기 위한 투표 시작됩니다.

• 새 기본 단계가 시작되면 term 필드를 증가시켜 새 기본에 이루어진 구성 변경 사항을 이전 기본에 이루어진 변경 사항과 구별합니다.

• 프라이머리 단계가 중단되면 더 이상 모든 클라이언트 연결이 닫히지 않지만 진행 중이던 쓰기는 종료됩니다. 자세한 내용은 동작을 참조하세요.

클러스터가 새 프라이머리를 선택하기까지의 시간 중앙값은 기본값 replica configuration settings을 가정할 때 일반적으로 12초를 초과하지 않아야 합니다. 여기에는 예비선거를 사용할 수 없는 상태로 표시하고 선거를 호출하여 완료하는 데 필요한 시간이 포함됩니다. settings.electionTimeoutMillis 복제 구성 옵션을 수정하여 이 기간을 조정할 수 있습니다. 네트워크 지연 시간 등 여러 요인으로 인해 복제본 세트 선택을 마치는 데 필요한 시간이 길어질 수 있습니다. 이렇게 되면 결국 프라이머리 노드 없이 클러스터가 작동할 수 있는 시간의 양에 영향을 미칠 수 있습니다. 이러한 요인들은 특정 클러스터 아키텍처에 따라 달라집니다.

선택 프로세스 중에 클러스터는 새 기본을 선택할 때까지 쓰기 작업을 수락할 수 없습니다.

애플리케이션 연결 로직에는 자동 페일오버 및 후속 투표에 대한 허용 범위가 포함되어야 합니다. MongoDB 드라이버는 프라이머리의 손실을 감지하고 특정 쓰기 작업을 한 번만 자동으로 재시도할 수 있으며, 자동 페일오버 및 투표에 대한 추가 기본 처리 기능을 제공합니다.

호환 가능한 드라이버는 기본적으로 재시도 가능 쓰기를 활성화

운영 클러스터에 미치는 잠재적 영향을 더욱 줄이려면 예약된 유지 관리 기간 동안에만 재구성하십시오.

{ force: true }

회원 탈퇴 후 나가는 연결 제거

Using replSetReconfig to remove a replica set member does not automatically drop open outgoing connections from other replica set members to the removed member.

기본적으로 복제 세트 구성원은 제거된 구성원에 대한 연결을 제거하기 전에 5분 동안 기다립니다. 샤드된 복제본 세트에서는 ShardingTaskExecutorPoolHostTimeoutMS 서버 매개변수를 사용하여 이 시간 제한을 수정할 수 있습니다.

복제본 세트에서 제거된 노드로 나가는 모든 연결을 즉시 삭제하려면 복제본 세트의 나머지 각 노드에 대해 dropConnections 관리 명령을 실행합니다.

db.adminCommand(
  {
    "dropConnections" : 1,
    "hostAndPort" : [
      "<hostname>:<port>"
    ]
  }
)

<hostname> <port> 0} 및 을 제거된 멤버의 이름으로 바꿉니다.

회원 우선순위 및 투표

• priority 2}가 0보다 큰 멤버는 0 를 가질 수 votes 없습니다.

• 투표권이 없는 경우(예 votes { 2}는 0) 멤버는 priority 이 0이어야 합니다.