Debian/Ubuntu에 ClickHouse 설치

Debian/Ubuntu Linux에 ClickHouse 설치

Debian 또는 Ubuntu에서는 공식 사전 컴파일 deb 패키지 사용을 권장합니다.

1. ​

   권장 사항 검토

   ClickHouse를 설치하기 전에 다음 권장 사항을 확인하십시오:

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

   스토리지 요구 사항 추정

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

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

   더 자세한 하드웨어 요구 사항은 “사이징 및 하드웨어 권장 사항”을 참조하십시오.

2. ​

   Debian 리포지토리 설정

   ClickHouse를 설치하려면 다음 명령을 실행하십시오.

   # 필수 패키지 설치
   sudo apt-get install -y apt-transport-https ca-certificates curl gnupg
   
   # ClickHouse GPG 키를 다운로드하여 키링에 저장
   curl -fsSL 'https://packages.clickhouse.com/rpm/lts/repodata/repomd.xml.key' | sudo gpg --dearmor -o /usr/share/keyrings/clickhouse-keyring.gpg
   
   # 시스템 아키텍처 확인
   ARCH=$(dpkg --print-architecture)
   
   # apt 소스에 ClickHouse 리포지토리 추가
   echo "deb [signed-by=/usr/share/keyrings/clickhouse-keyring.gpg arch=${ARCH}] https://packages.clickhouse.com/deb stable main" | sudo tee /etc/apt/sources.list.d/clickhouse.list
   
   # apt 패키지 목록 업데이트
   sudo apt-get update
   

   • 필요에 따라 다른 릴리스 유형을 사용하려면 stable 대신 lts를 사용할 수 있습니다.
   • packages.clickhouse.com에서 패키지를 수동으로 다운로드하여 설치할 수 있습니다.

   
   

   구형 배포판에서 deb 패키지를 설치하는 방법

   # 필수 패키지 설치
   sudo apt-get install apt-transport-https ca-certificates dirmngr
   
   # 패키지 인증을 위해 ClickHouse GPG 키 추가
   sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 8919F6BD2B48D754
   
   # apt 소스에 ClickHouse 리포지토리 추가
   echo "deb https://packages.clickhouse.com/deb stable main" | sudo tee \
       /etc/apt/sources.list.d/clickhouse.list
       
   # apt 패키지 목록 업데이트
   sudo apt-get update
   
   # ClickHouse 서버 및 클라이언트 패키지 설치
   sudo apt-get install -y clickhouse-server clickhouse-client
   
   # ClickHouse 서버 서비스 시작
   sudo service clickhouse-server start
   
   # ClickHouse 명령줄 클라이언트 실행
   clickhouse-client # 비밀번호를 설정했다면 "clickhouse-client --password"를 사용하십시오.
   
3. ​

   ClickHouse 서버 및 클라이언트 설치

   sudo apt-get install -y clickhouse-server clickhouse-client
   
4. ​

   ClickHouse 시작

   ClickHouse 서버를 시작하려면 다음을 실행하십시오.

   sudo service clickhouse-server start
   

   ClickHouse 클라이언트를 시작하려면 다음을 실행하십시오.

   clickhouse-client
   

   서버에 비밀번호를 설정한 경우에는 다음을 실행해야 합니다.

   clickhouse-client --password
   
5. ​

   독립형 ClickHouse Keeper 설치

   운영 환경에서는 전용 노드에서 ClickHouse Keeper를 실행할 것을 강력히 권장합니다. 테스트 환경에서 ClickHouse 서버와 ClickHouse Keeper를 동일한 서버에서 실행하기로 했다면 ClickHouse 서버에 ClickHouse Keeper가 포함되어 있으므로 별도로 설치할 필요가 없습니다.

   독립형 ClickHouse Keeper 서버에 clickhouse-keeper를 설치하려면 다음을 실행하십시오.

   sudo apt-get install -y clickhouse-keeper
   
6. ​

   ClickHouse Keeper 활성화 및 시작

   sudo systemctl enable clickhouse-keeper
   sudo systemctl start clickhouse-keeper
   sudo systemctl status clickhouse-keeper
   

​

패키지

사용 가능한 deb 패키지는 아래와 같습니다.

Package	Description
clickhouse-common-static	컴파일된 ClickHouse 바이너리 파일을 설치합니다.
clickhouse-server	clickhouse-server용 심볼릭 링크를 생성하고 기본 서버 구성을 설치합니다.
clickhouse-client	clickhouse-client 및 기타 클라이언트 관련 도구용 심볼릭 링크를 생성하고 클라이언트 설정 파일을 설치합니다.
clickhouse-common-static-dbg	디버그 정보가 포함된 컴파일된 ClickHouse 바이너리 파일을 설치합니다.
clickhouse-keeper	전용 ClickHouse Keeper 노드에 ClickHouse Keeper를 설치할 때 사용합니다. ClickHouse Keeper를 ClickHouse 서버와 동일한 서버에서 실행하는 경우 이 패키지를 설치할 필요가 없습니다. ClickHouse Keeper와 기본 ClickHouse Keeper 설정 파일을 설치합니다.

특정 버전의 ClickHouse를 설치해야 하는 경우 모든 패키지를 동일한 버전으로 설치해야 합니다. sudo apt-get install clickhouse-server=21.8.5.7 clickhouse-client=21.8.5.7 clickhouse-common-static=21.8.5.7