nodetool getminimumrf — 최소 키스페이스 복제 계수 조회
nodetool getminimumrf — 최소 키스페이스 복제 계수 조회
이 명령은 키스페이스 생성 시 허용되는 최소 복제 계수(minimum replication factor)의 현재 설정값을 조회해요. setminimumrf로 설정한 값이나 cassandra.yaml의 minimum_keyspace_rf 설정으로 지정한 값을 노드에서 읽어 확인하는 데 사용합니다.
참고: 공식 Apache Cassandra 문서에는 현재
getminimumrf전용 페이지가 존재하지 않으며(404), 이 명령은setminimumrf명령 및minimum_keyspace_rf설정과 함께 소개되어 있어요.
본문
getminimumrf는 키스페이스 생성/변경 시 복제 계수가 특정 최솟값 아래로 내려가는 것을 막기 위해 설정된 minimum_keyspace_rf 값을 조회해요. 이 값을 알면 운영상 안전하지 않은 과소 복제(under-replication)를 예방하기 위해 현재 노드에 적용된 제한이 얼마인지 파악할 수 있어요.
관련 설정은 cassandra.yaml의 default_keyspace_rf(기본값 1)와 minimum_keyspace_rf(기본값 0)입니다. 복제 계수를 명시하지 않으면 default_keyspace_rf가 적용되고, 그 값이 minimum_keyspace_rf보다 작으면 ConfigurationException이 발생합니다.
getminimumrf를 실행하면 현재 노드에 설정된 최소 복제 계수가 다음과 같이 출력됩니다.
nodetool getminimumrf
→ 기본값(0)이 설정된 경우 0이 출력되고, setminimumrf로 값을 변경하거나 yaml 설정을 바꾸면 그 값이 표시돼요.
이 값은 minimum_keyspace_rf가 0보다 작아서는 안 되며, default_keyspace_rf는 minimum_keyspace_rf보다 항상 크거나 같아야 합니다. 이 명령(또는 해당 yaml 설정)은 각 노드에 적용되므로, 클러스터 전체에 일관된 동작을 원한다면 모든 노드에서 동일한 값을 조회·설정해야 해요.