tgz 아카이브를 사용해 ClickHouse 설치

MacOS에서 ClickHouse 설치

​

tgz 아카이브를 사용하여 ClickHouse 설치

deb 또는 rpm 패키지를 설치할 수 없는 모든 Linux 배포판에서는 공식 사전 컴파일 tgz 아카이브를 사용하는 것이 좋습니다.

1. ​

   권장 사항 검토

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

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

   스토리지 요구 사항 추정

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

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

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

2. ​

   최신 안정 버전 다운로드 및 설치

   필요한 버전은 리포지토리 https://packages.clickhouse.com/tgz/ 에서 curl 또는 wget으로 다운로드할 수 있습니다. 다운로드한 아카이브는 압축을 해제한 뒤 설치 스크립트로 설치해야 합니다.

   아래는 최신 안정 버전을 설치하는 예시입니다.

   프로덕션 환경에서는 최신 stable 버전을 사용하는 것이 좋습니다. 릴리스 번호는 이 GitHub 페이지에서 접미사 -stable이 붙은 항목으로 확인할 수 있습니다.

3. ​

   최신 ClickHouse 버전 가져오기

   GitHub에서 최신 ClickHouse 버전을 가져와 LATEST_VERSION 변수에 저장합니다.

   LATEST_VERSION=$(curl -s https://raw.githubusercontent.com/ClickHouse/ClickHouse/master/utils/list-versions/version_date.tsv | \
       grep -Eo '[0-9]+\.[0-9]+\.[0-9]+\.[0-9]+' | sort -V -r | head -n 1)
   export LATEST_VERSION
   
4. ​

   시스템 아키텍처 감지

   시스템 아키텍처를 감지하고 그에 맞게 ARCH 변수를 설정합니다.

   case $(uname -m) in
     x86_64) ARCH=amd64 ;;         # Intel/AMD 64비트 프로세서용
     aarch64) ARCH=arm64 ;;        # ARM 64비트 프로세서용
     *) echo "Unknown architecture $(uname -m)"; exit 1 ;; # 지원되지 않는 아키텍처면 종료
   esac
   
5. ​

   각 ClickHouse 구성 요소의 tarball 다운로드

   각 ClickHouse 구성 요소의 tarball을 다운로드합니다. 이 루프는 먼저 아키텍처별 패키지를 시도한 다음, 일반 패키지를 사용합니다.

   for PKG in clickhouse-common-static clickhouse-common-static-dbg clickhouse-server clickhouse-client clickhouse-keeper
   do
     curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION-${ARCH}.tgz" \
       || curl -fO "https://packages.clickhouse.com/tgz/stable/$PKG-$LATEST_VERSION.tgz"
   done
   
6. ​

   패키지 압축 해제 및 설치

   아래 명령을 실행하여 다음 패키지를 압축 해제하고 설치합니다.

   • clickhouse-common-static

   # clickhouse-common-static 패키지 압축 해제 및 설치
   tar -xzvf "clickhouse-common-static-$LATEST_VERSION-${ARCH}.tgz" \
     || tar -xzvf "clickhouse-common-static-$LATEST_VERSION.tgz"
   sudo "clickhouse-common-static-$LATEST_VERSION/install/doinst.sh"
   

   • clickhouse-common-static-dbg

   # 디버그 심볼 패키지 압축 해제 및 설치
   tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION-${ARCH}.tgz" \
     || tar -xzvf "clickhouse-common-static-dbg-$LATEST_VERSION.tgz"
   sudo "clickhouse-common-static-dbg-$LATEST_VERSION/install/doinst.sh"
   

   • clickhouse-server

   # 구성과 함께 서버 패키지 압축 해제 및 설치
   tar -xzvf "clickhouse-server-$LATEST_VERSION-${ARCH}.tgz" \
     || tar -xzvf "clickhouse-server-$LATEST_VERSION.tgz"
   sudo "clickhouse-server-$LATEST_VERSION/install/doinst.sh" configure
   sudo /etc/init.d/clickhouse-server start  # 서버 시작
   

   • clickhouse-client

   # 클라이언트 패키지 압축 해제 및 설치
   tar -xzvf "clickhouse-client-$LATEST_VERSION-${ARCH}.tgz" \
     || tar -xzvf "clickhouse-client-$LATEST_VERSION.tgz"
   sudo "clickhouse-client-$LATEST_VERSION/install/doinst.sh"