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

Databrain을 ClickHouse에 연결하기

Community Maintained

Databrain은 내장형 분석 플랫폼으로, 고객과 인터랙티브 대시보드, 메트릭 및 데이터 시각화를 생성하고 공유할 수 있도록 해줍니다. Databrain은 HTTPS 인터페이스를 통해 ClickHouse에 연결하므로, 모던하고 사용자 친화적인 인터페이스를 사용하여 ClickHouse 데이터를 쉽게 시각화하고 분석할 수 있습니다.

ClickHouse 데이터 시각화를 보여주는 Databrain 대시보드 인터페이스

이 가이드는 Databrain을 ClickHouse 인스턴스에 연결하는 방법을 단계별로 설명합니다.

사전 준비 사항​

  • 자체 인프라 또는 ClickHouse Cloud에서 운영되는 ClickHouse 데이터베이스.
  • Databrain 계정.
  • 데이터 소스를 연결할 Databrain 워크스페이스.

Databrain을 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 관리자가 설정합니다.

2. Databrain IP 주소를 허용합니다(필요한 경우)​

ClickHouse 인스턴스에서 IP 필터링을 사용하는 경우 Databrain의 IP 주소를 허용 목록에 추가해야 합니다.

ClickHouse Cloud 사용자의 경우:

  1. ClickHouse Cloud 콘솔에서 서비스로 이동합니다.
  2. Settings → Security로 이동합니다.
  3. 허용 목록(allow list)에 Databrain의 IP 주소를 추가합니다.
팁

허용 목록에 추가해야 하는 최신 IP 주소 목록은 Databrain의 IP 허용(whitelisting) 문서를 참고하십시오.

3. Databrain에서 ClickHouse를 데이터 소스로 추가합니다​

  1. Databrain 계정에 로그인한 후, 데이터 소스를 추가하려는 워크스페이스로 이동합니다.

  2. 내비게이션 메뉴에서 Data Sources를 클릭합니다.

Databrain 데이터 소스 메뉴

  1. Add a Data Source 또는 Connect Data Source를 클릭합니다.

  2. 사용 가능한 커넥터 목록에서 ClickHouse를 선택합니다.

ClickHouse 옵션이 표시된 Databrain 커넥터 선택 화면
  1. 연결 정보를 입력합니다:
    • Destination Name: 이 연결을 식별하기 쉬운 이름으로 입력합니다(예: "Production ClickHouse" 또는 "Analytics DB")
    • Host: ClickHouse 호스트 URL을 입력합니다(예: https://your-instance.region.aws.clickhouse.cloud)
    • Port: 8443를 입력합니다(ClickHouse의 기본 HTTPS 포트)
    • Username: ClickHouse 사용자 이름을 입력합니다.
    • Password: ClickHouse 비밀번호를 입력합니다.
구성 필드가 있는 Databrain ClickHouse 연결 양식

  1. Test Connection을 클릭하여 Databrain이 ClickHouse 인스턴스에 연결할 수 있는지 확인합니다.

  2. 연결이 성공하면 Save 또는 Connect를 클릭하여 데이터 소스를 추가합니다.

4. 사용자 권한을 구성합니다​

연결에 사용하는 ClickHouse 사용자에게 필요한 권한이 있는지 확인합니다:

-- Grant permissions to read schema information
GRANT SELECT ON information_schema.* TO your_databrain_user;

-- Grant read access to your database and tables
GRANT SELECT ON your_database.* TO your_databrain_user;

your_databrain_user와 your_database를 실제 사용자 이름과 데이터베이스 이름으로 바꾸십시오.

ClickHouse에서 Databrain 사용하기​

데이터 탐색하기​

  1. 연결이 완료되면 Databrain에서 워크스페이스로 이동합니다.

  2. 데이터 탐색기에서 ClickHouse 테이블 목록이 표시됩니다.

ClickHouse 테이블을 보여주��는 Databrain 데이터 탐색기
  1. 테이블을 클릭하여 스키마를 확인하고 데이터를 미리 봅니다.

메트릭과 시각화 생성하기​

  1. Create Metric을 클릭하여 ClickHouse 데이터로부터 시각화 생성을 시작합니다.

  2. ClickHouse 데이터 소스를 선택하고 시각화하려는 테이블을 선택합니다.

  3. Databrain의 직관적인 인터페이스를 사용하여 다음을 수행합니다.

    • 차원과 측정값을 선택합니다.
    • 필터와 집계를 적용합니다.
    • 시각화 유형을 선택합니다 (막대 차트, 선 차트, 파이 차트, 테이블 등).
    • 고급 분석을 위해 사용자 정의 SQL 쿼리를 추가합니다.

  4. 메트릭을 저장하여 여러 대시보드에서 재사용합니다.

대시보드 구성하기​

  1. Create Dashboard를 클릭하여 대시보드 구성을 시작합니다.

  2. 저장된 메트릭을 드래그 앤 드롭하여 대시보드에 추가합니다.

  3. 대시보드의 레이아웃과 외형을 사용자 지정합니다.

여러 ClickHouse 시각화가 포함된 Databrain 대시보드
  1. 대시보드를 팀과 공유하거나 애플리케이션에 삽입합니다.

고급 기능​

Databrain은 ClickHouse와 함께 작업할 때 다양한 고급 기능을 제공합니다.

  • Custom SQL Console: ClickHouse 데이터베이스에 대해 직접 사용자 정의 SQL 쿼리를 작성하고 실행합니다.
  • Multi-tenancy 및 single-tenancy: single-tenant 및 multi-tenant 아키텍처 모두에서 ClickHouse 데이터베이스를 연결합니다.
  • Report Scheduling: 자동 보고서를 예약하고 이해관계자에게 이메일로 전송합니다.
  • AI-powered Insights: AI를 사용하여 데이터로부터 요약과 인사이트를 생성합니다.
  • Embedded Analytics: 애플리케이션에 대시보드와 메트릭을 직접 삽입합니다.
  • Semantic Layer: 재사용 가능한 데이터 모델과 비즈니스 로직을 생성합니다.

문제 해결​

연결 실패​

ClickHouse에 연결할 수 없는 경우 다음 사항을 확인합니다.

  1. 자격 증명 확인: 사용자 이름, 비밀번호, 호스트 URL을 다시 한 번 확인합니다.
  2. 포트 확인: HTTPS를 사용하는 경우 포트 8443을, SSL을 사용하지 않는 HTTP를 사용하는 경우 포트 8123을 사용하고 있는지 확인합니다.
  3. IP 화이트리스트: Databrain의 IP 주소가 ClickHouse 방화벽/보안 설정에서 화이트리스트에 등록되어 있는지 확인합니다.
  4. SSL/TLS: HTTPS를 사용하는 경우 SSL/TLS가 올바르게 구성되어 있는지 확인합니다.
  5. 사용자 권한: 해당 사용자가 information_schema 및 대상 데이터베이스에 대해 SELECT 권한을 가지고 있는지 확인합니다.

느린 쿼리 성능​

쿼리 실행 속도가 느린 경우 다음을 수행합니다.

  1. 쿼리 최적화: 필터와 집계를 효율적으로 사용합니다.
  2. materialized view 생성: 자주 사용되는 집계가 있다면 ClickHouse에 materialized view를 생성하는 것을 고려합니다.
  3. 적절한 데이터 타입 사용: ClickHouse 스키마에서 최적의 데이터 타입을 사용하고 있는지 확인합니다.
  4. 인덱스 최적화: ClickHouse의 기본 키와 skipping 인덱스를 활용합니다.

더 알아보기​

Databrain 기능과 강력한 분석 환경을 구축하는 방법에 대한 자세한 내용은 다음을 참고하십시오: