본문으로 바로가기
본문으로 바로가기

NixOS에 ClickHouse 설치

ClickHouse는 Nixpkgs 저장소에서 제공되며 LinuxmacOS에서 Nix를 사용해 설치할 수 있습니다.

권장 사항 검토

ClickHouse를 설치하기 전에 다음 권장 사항을 검토하십시오.

  • Swap: 프로덕션 환경에서는 운영 체제의 스왑 파일을 비활성화하십시오.
  • Disk space: ClickHouse 바이너리를 설치하려면 최소 2.5 GB의 디스크 공간이 필요합니다.
  • Network: 분산 배포(클러스터링)에서는 최소 10 Gbit의 네트워크 연결을 사용하십시오. 대량의 중간 데이터가 포함된 분산 쿼리를 처리할 때와 복제 시에는 네트워크 대역폭이 매우 중요합니다.

스토리지 요구 사항 추정

데이터에 필요한 디스크 공간을 추정하려면 다음 단계를 따르십시오.

  1. 데이터 용량 추정: 데이터의 샘플을 추출해 평균 행 크기를 계산한 다음, 저장할 예정인 행 수를 곱하십시오.
  2. 압축 계수 적용: 샘플 데이터를 ClickHouse에 로드한 뒤 원본 데이터 크기와 저장된 테이블 크기를 비교하십시오. 예를 들어 클릭스트림 데이터는 일반적으로 6~10배 압축됩니다.
  3. 레플리카 수 반영: 여러 레플리카에 데이터를 저장할 계획이라면 추정 용량에 레플리카 수를 곱하십시오.

하드웨어 요구 사항에 대한 자세한 내용은 "사이징 및 하드웨어 권장 사항"을 참조하십시오.

Nix를 사용해 ClickHouse 설치

Nix를 사용하면 ClickHouse를 시스템에 영구적으로 추가하지 않고도 설치할 수 있습니다:

# 최신 안정(stable) 버전 설치
nix shell nixpkgs#clickhouse

# 또는 LTS 버전 설치
nix shell nixpkgs#clickhouse-lts

이렇게 하면 현재 셸 세션에서 clickhouse 바이너리를 사용할 수 있습니다.

  • nixpkgs#clickhouse 패키지는 최신 안정(stable) 버전을 제공합니다.
  • nixpkgs#clickhouse-lts 패키지는 장기 지원(Long Term Support) 버전을 제공합니다.
  • 두 패키지는 모두 Linux와 macOS에서 사용할 수 있습니다.

영구 설치

시스템에 ClickHouse를 영구적으로 설치하려면:

NixOS 사용자configuration.nix에 다음을 추가합니다:

environment.systemPackages = with pkgs; [
  clickhouse
];

그런 다음 시스템을 재빌드합니다:

sudo nixos-rebuild switch

NixOS가 아닌 사용자는 Nix profile을 사용해 설치합니다:

# 최신 안정(stable) 버전 설치
nix profile install nixpkgs#clickhouse

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

ClickHouse 서버 시작

설치 후에는 다음과 같이 ClickHouse 서버를 시작합니다:

clickhouse-server

기본적으로 서버는 기본 구성으로 시작되며 localhost:9000에서 수신 대기합니다.

NixOS에서 운영 환경으로 사용할 경우 ClickHouse를 시스템 서비스로 구성하는 것이 좋습니다. 사용 가능한 구성 옵션은 NixOS 매뉴얼을 참고하십시오.

ClickHouse 클라이언트 시작

ClickHouse 서버에 연결하려면 새 터미널을 열고 다음을 실행합니다:

clickhouse-client

Nix 패키지 소개

Nixpkgs의 ClickHouse 패키지에는 다음이 포함됩니다:

  • clickhouse-server - ClickHouse 데이터베이스 서버
  • clickhouse-client - ClickHouse에 연결하기 위한 명령줄 클라이언트
  • clickhouse-local - 로컬 파일에서 SQL 쿼리를 실행하기 위한 도구
  • 기타 ClickHouse 유틸리티

Nixpkgs의 ClickHouse 패키지에 대한 자세한 내용은 다음을 참조하십시오: