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

Zing Data를 ClickHouse에 연결하기

Community Maintained

Zing Data는 데이터 탐색 및 시각화를 위한 플랫폼입니다. Zing Data는 ClickHouse에서 제공하는 JS 드라이버를 사용하여 ClickHouse에 연결합니다.

연결 방법

  1. 연결 정보를 준비합니다.

HTTP(S)로 ClickHouse에 연결하려면 다음 정보가 필요합니다:

Parameter(s)Description
HOST and PORT일반적으로 TLS를 사용할 때는 포트가 8443이고, TLS를 사용하지 않을 때는 8123입니다.
DATABASE NAME기본적으로 default라는 데이터베이스가 있으며, 연결하려는 데이터베이스의 이름을 사용합니다.
USERNAME and PASSWORD기본값으로 사용자 이름은 default입니다. 사용하려는 용도에 적합한 사용자 이름을 사용합니다.

ClickHouse Cloud 서비스에 대한 세부 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다. 서비스를 선택한 다음 Connect를 클릭하십시오:

ClickHouse Cloud 서비스 Connect 버튼

HTTPS를 선택하십시오. 연결 정보는 예제 curl 명령에 표시됩니다.

ClickHouse Cloud HTTPS 연결 정보

자가 관리형 ClickHouse를 사용하는 경우, 연결 정보는 ClickHouse 관리자가 설정합니다.

  1. Zing Data 다운로드 또는 접속

    • 모바일에서 Zing Data와 함께 ClickHouse를 사용하려면 Google Play Store 또는 Apple App Store에서 Zing Data 앱을 다운로드합니다.

    • 웹에서 Zing Data와 함께 ClickHouse를 사용하려면 Zing 웹 콘솔에 접속하여 계정을 만듭니다.

  2. 데이터 소스 추가

    • Zing Data에서 ClickHouse 데이터를 조회하려면 데이터 소스(datasource)를 정의해야 합니다. Zing Data 모바일 앱 메뉴에서 Sources를 선택한 후 Add a Datasource를 클릭합니다.

    • 웹에서 데이터 소스를 추가하려면 상단 메뉴에서 Data Sources를 클릭하고 New Datasource를 클릭한 다음 드롭다운 메뉴에서 ClickHouse를 선택합니다.

    드롭다운 메뉴에서 New Datasource 버튼과 ClickHouse 옵션이 표시된 Zing Data 인터페이스

  3. 연결 정보를 입력한 후 Check Connection을 클릭합니다.

    서버, 포트, 데이터베이스, 사용자 이름, 비밀번호 필드가 있는 Zing Data의 ClickHouse 연결 구성 폼

  4. 연결에 성공하면 Zing에서 테이블 선택 단계로 이동합니다. 필요한 테이블을 선택하고 Save를 클릭합니다. Zing에서 데이터 소스에 연결할 수 없는 경우, 자격 증명을 확인하고 다시 시도하라는 메시지가 표시됩니다. 자격 증명을 확인하고 다시 시도했음에도 문제가 계속되면 여기에서 Zing 지원팀에 문의하십시오.

    체크박스와 함께 사용 가능한 ClickHouse 테이블이 표시된 Zing Data 테이블 선택 인터페이스

  5. ClickHouse 데이터 소스가 추가되면 Zing 조직의 모든 사용자가 Data Sources / Sources 탭에서 해당 데이터 소스를 사용할 수 있습니다.

Zing Data에서 차트와 대시보드 생성하기

  1. ClickHouse 데이터 소스가 추가된 후 웹에서는 Zing App을 클릭하고, 모바일에서는 해당 데이터 소스를 눌러 차트 생성을 시작합니다.

  2. 테이블 목록에서 원하는 테이블을 클릭하여 차트를 생성합니다.

    사용 가능한 ClickHouse 테이블이 있는 테이블 목록을 보여주는 Zing Data 인터페이스

  3. 시각적 쿼리 빌더를 사용해 필요한 필드, 집계 등을 선택한 후 Run Question을 클릭합니다.

    필드 선택 및 집계 옵션이 포함된 Zing Data 시각적 쿼리 빌더 인터페이스

  4. SQL에 익숙하다면, 사용자 지정 SQL을 작성해 쿼리를 실행하고 차트를 생성할 수도 있습니다.

    SQL 쿼리 작성 인터페이스를 보여주는 Zing Data의 SQL 편집기 모드
    표 형식으로 데이터가 표시된 Zing Data의 SQL 쿼리 결과 화면
  5. 예시 차트는 다음과 같습니다. 질문은 점 3개 메뉴를 사용해 저장할 수 있습니다. 차트에 댓글을 남기고, 팀원을 태그하며, 실시간 경고를 생성하고, 차트 유형을 변경하는 등의 작업을 할 수 있습니다.

    옵션 메뉴와 함께 ClickHouse 데이터가 표시된 Zing Data의 예시 차트 시각화

  6. 대시보드는 홈 화면의 Dashboards 아래에 있는 "+" 아이콘을 사용해 생성할 수 있습니다. 기존 질문을 드래그하여 대시보드에 배치해 표시할 수 있습니다.

    여러 시각화가 대시보드 레이아웃으로 배열된 Zing Data 대시보드 화면