Styxis
Company
Knowledge

ClickHouse shardNum의 시작 번호가 바뀌면: 범위와 서버 매핑을 함께 검사하기

정수 타입만 맞는 샤드 번호는 분산 결과의 출처 계약을 보장하지 않는다.

번호에도 의미가 있다

분산 식별자의 시작값과 허용 집합은 단순 정수 타입 검사보다 구체적인 계약이다. 번호가 하나씩 이동하면 대시보드의 샤드별 집계나 라우팅 기준이 다른 서버를 뜻할 수 있다. Truthound 검사는 승인 범위와 실제 인스턴스 매핑을 서로 다른 조건으로 다뤄야 한다. [1, 2, 3]

계획 직렬화 설정의 대조

ClickHouse 공개 이슈는 distributed plan과 query plan 직렬화 설정을 함께 사용한 두 샤드 재현에서 shardNum 값이 기대 1·2 대신 0·1로 나오는 사례를 제시한다. 설정 조합을 보존하지 않으면 같은 데이터에서 나타나는 번호 차이를 재현하기 어렵다. [1]

최솟값 검사의 역할과 한계

설명용 승인 번호가 1과 2라면 최솟값 1은 하한을 만족하고 0은 실패한다. 그러나 1과 2가 실제 서버에 반대로 붙어도 범위는 통과한다. 따라서 이 검사에서 허용 범위가 맞는다는 결론과 출처가 맞는다는 결론을 분리해야 한다. [1, 3]

전환 전후의 승인 자료

샤드 번호의 허용 범위와 실제 서버 매핑을 환경별로 고정하고 설정 변경 전후에 번호 이동을 검사한다. Truthound Core의 BetweenValidator로 준비한 번호 열의 상·하한을 확인한 뒤, 서버 식별자와 번호의 짝도 승인 매핑과 대조한다. 이 검사는 분산 계획 직렬화를 수정하지 않는다. 설정을 바꾼 대조 실행이 가능하면 행 값뿐 아니라 출처 매핑까지 함께 확인한다. [1, 2, 3]

적용 조건

같은 분산 실행의 shard_number와 실제 서버 식별자를 수집하고 환경별 승인 번호·서버 매핑을 독립 기준으로 둔다.

대안

계획 직렬화 설정을 바꾼 대조군에서 실제 서버 매핑을 수집한다.

한계

  • 번호 범위가 맞아도 다른 샤드와 바뀌었을 수 있다. Truthound는 분산 계획 직렬화를 수정하지 않는다.

근거

사건 확인일
대상 확인일
수정일