ClickHouse 리뷰어 가이드라인

ClickHouse 리뷰어 가이드라인에 대해 설명합니다.

이 페이지는 ClickHouse 리뷰어를 위한 입문 자료와 가이드를 제공합니다. ClickHouse 리뷰어 업무 범위 # ClickHouse 리뷰어는 ClickHouse OLAP 데이터베이스에 경험이 있는 도메인 전문가입니다. ClickHouse와 상호작용하는 애플리케이션 코드가 수정될 때마다 ClickHouse 데이터베이스 리뷰가 필요합니다. 예시는 다음과 같습니다: 새 ClickHouse 마이그레이션 추가. ClickHouse 쿼리를 실행하는 서비스 클래스 변경. 새 ClickHouse 쿼리 도입. 리뷰어의 책임은 ClickHouse 관련 변경 사항을 검증하고 ClickHouse가 구성될 수 있는 모든 GitLab 환경에서 올바르게 작동하는지 확인하는 것입니다. ClickHouse 리뷰어를 위한 리소스 # GitLab 내 ClickHouse : GitLab에서의 ClickHouse 사용 개요. GitLab 데이터베이스 리뷰어 가이드라인 : 데이터베이스 마이그레이션에 관해 특히 ClickHouse에도 적용되는 일반 원칙. ClickHouse는 관계형 데이터베이스와 동일한 배포 전 및 배포 후 마이그레이션 전략을 따릅니다. 일반 가이드라인 # 데이터베이스 스키마 일관성 보장 # 현재 ClickHouse 데이터베이스 스키마는 단일 main.sql 파일에 저장됩니다. 이 파일은 ActiveRecord 마이그레이션과 유사하게 마이그레이션 실행 시 자동으로 업데이트됩니다. 때로는 main.sql 파일이 머지 리퀘스트에서 업데이트되거나 커밋되지 않아 마이그레이션으로 구축된 스키마와 커밋된 스키마 파일 간에 불일치가 발생할 수 있습니다. 이 문제를 감지하기 위해 CI 잡( clickhouse:check-schema )이 테스트 스테이지 중에 실행됩니다. 이 잡은 새로 구축된 스키마를 main.sql 과 비교하고 차이가 있으면 실패합니다. 이 잡은 실패해도 괜찮도록 허용되지 않습니다 . 실패하면 MR 파이프라인이 실패합니다. 리뷰어로서 잡 로그를 항상 확인하세요. 실패하는 경우 차이를 신중하게 검사하세요. 공백이 아닌 관련 차이는 MR 작성자와 논의해야 합니다. 거짓 양성의 경우(예: ClickHouse 버전 불일치로 인한 차이), MR에 pipeline:skip-check-clickhouse-schema 라벨을 추가하여 이 검사를 건너뜁니다. 정당한 스키마 차이를 해결하기 위해 작성자는 모든 마이그레이션이 실행되도록 하고 스키마를 덤프할 수 있습니다: bundle exec rake gitlab:clickhouse:migrate; bundle exec rake gitlab:clickhouse:schema:dump 데이터베이스 쿼리 리뷰 # GitLab의 ClickHouse 쿼리는 두 가지 방법으로 작성할 수 있습니다: Raw SQL 쿼리 QueryBuilder – ActiveRecord와 유사한 추상화( 문서 ) Raw SQL 쿼리를 리뷰할 때 변수 보간에 주의를 기울이세요: 권장: 민감한 데이터가 로그에 기록되지 않도록 변수는 ClickHouse의