nodetool setminimumrf — 최소 키스페이스 복제 계수 설정
nodetool setminimumrf — 최소 키스페이스 복제 계수 설정
이 명령은 키스페이스 생성 시 허용되는 최소 복제 계수(minimum replication factor)를 설정해요. 키스페이스를 만들 때 지정한 복제 계수가 이 값보다 작으면 거부되도록 제한하는 역할을 하며, setdefaultrf와 함께 클러스터 복제 계수를 안전하게 관리하는 데 사용합니다.
참고: 공식 Apache Cassandra 문서에는 현재
setminimumrf전용 페이지가 존재하지 않으며(404), 이 명령은setdefaultrf명령 및minimum_keyspace_rf설정과 함께 소개되어 있어요.
본문
setminimumrf는 키스페이스 생성/변경 시 복제 계수가 특정 최솟값 아래로 내려가는 것을 막아, 운영상 안전하지 않은 과소 복제(under-replication)를 예방해요.
관련 설정은 cassandra.yaml의 default_keyspace_rf(기본값 1)와 minimum_keyspace_rf(기본값 0)입니다. 복제 계수를 명시하지 않으면 default_keyspace_rf가 적용되고, 그 값이 minimum_keyspace_rf보다 작으면 ConfigurationException이 발생합니다. 예를 들어 minimum_keyspace_rf를 2로 설정한 뒤 replication_factor : 1로 키스페이스를 만들려 하면 다음처럼 거부됩니다.
CREATE KEYSPACE ks1 WITH replication={ 'class' : 'SimpleStrategy', 'replication_factor' : 1 }
→ ConfigurationException: Replication factor cannot be less than minimum_keyspace_rf (2), found 1
이 값은 minimum_keyspace_rf가 0보다 작아서는 안 되며, default_keyspace_rf는 minimum_keyspace_rf보다 항상 크거나 같아야 합니다. 이 명령(또는 해당 yaml 설정)은 각 노드에 적용되므로, 클러스터 전체에 일관된 동작을 원한다면 모든 노드에 동일하게 설정해야 해요.