메인 콘텐츠로 건너뛰기

NixOS에 ClickHouse 설치

ClickHouse는 Nixpkgs 리포지토리에서 제공되며, LinuxmacOS에서 Nix를 사용해 설치할 수 있습니다.
1

권장 사항 검토

ClickHouse를 설치하기 전에 다음 권장 사항을 확인하십시오:
  • 스왑: 운영 환경에서는 운영 체제의 스왑 파일을 비활성화하십시오.
  • 디스크 공간: ClickHouse 바이너리를 설치하려면 최소 2.5 GB의 디스크 공간이 필요합니다.
  • 네트워크: 분산 배포(클러스터링)에서는 최소 10 Gbit 네트워크 연결을 사용하십시오. 대량의 중간 데이터를 포함하는 분산 쿼리를 처리할 때와 복제 시에는 네트워크 대역폭이 매우 중요합니다.
스토리지 요구 사항 추정데이터에 필요한 디스크 공간을 추정하려면 다음 단계를 따르십시오:
  1. 데이터 양 추정: 데이터 샘플을 가져와 평균 행 크기를 계산한 다음, 저장할 행 수를 곱합니다.
  2. 압축 계수 적용: 샘플을 ClickHouse에 로드한 뒤 원본 데이터 크기와 저장된 테이블 크기를 비교합니다. 예를 들어 클릭스트림 데이터는 일반적으로 6~10배 압축됩니다.
  3. 레플리카 고려: 여러 레플리카에 데이터를 저장할 계획이라면 추정 용량에 레플리카 수를 곱합니다.
더 자세한 하드웨어 요구 사항은 “사이징 및 하드웨어 권장 사항”을 참조하십시오.
2

Nix를 사용해 ClickHouse 설치

Nix를 사용하면 시스템에 영구적으로 추가하지 않고도 ClickHouse를 설치할 수 있습니다:
# 최신 안정 버전 설치
nix shell nixpkgs#clickhouse

# 또는 LTS 버전 설치
nix shell nixpkgs#clickhouse-lts
이렇게 하면 현재 셸 세션에서 clickhouse 실행 파일을 사용할 수 있습니다.
  • nixpkgs#clickhouse 패키지는 최신 안정 버전을 제공합니다.
  • nixpkgs#clickhouse-lts 패키지는 장기 지원(Long Term Support) 버전을 제공합니다.
  • 두 패키지 모두 Linux와 macOS에서 사용할 수 있습니다.
3

영구 설치

시스템에 ClickHouse를 영구적으로 설치하려면 다음과 같이 하십시오:NixOS 사용자configuration.nix에 다음 내용을 추가하십시오:
environment.systemPackages = with pkgs; [
  clickhouse
];
그런 다음 시스템을 다시 빌드하십시오:
sudo nixos-rebuild switch
NixOS가 아닌 사용자는 Nix profile을 사용해 설치하십시오:
# 최신 안정 버전 설치
nix profile install nixpkgs#clickhouse

# 또는 LTS 버전 설치
nix profile install nixpkgs#clickhouse-lts
4

ClickHouse 서버 시작

설치 후 ClickHouse 서버를 시작할 수 있습니다:
clickhouse-server
기본적으로 서버는 기본 구성으로 시작되며 localhost:9000에서 연결을 수신 대기합니다.NixOS를 프로덕션 환경에서 사용하는 경우 ClickHouse를 시스템 서비스로 구성하는 것이 좋습니다. 사용 가능한 구성 옵션은 NixOS 설명서를 참조하십시오.
5

ClickHouse client 시작

ClickHouse 서버에 연결하려면 새 터미널을 열고 다음을 실행하십시오:
clickhouse-client

Nix 패키지 소개

Nixpkgs의 ClickHouse 패키지에는 다음이 포함되어 있습니다.
  • clickhouse-server - ClickHouse 데이터베이스 서버
  • clickhouse-client - ClickHouse에 연결하기 위한 command-line client
  • clickhouse-local - 로컬 파일에서 SQL 쿼리를 실행하는 도구
  • 기타 ClickHouse 유틸리티
Nixpkgs의 ClickHouse 패키지에 관한 자세한 내용은 다음을 참조하십시오.
마지막 수정일 2026년 6월 10일