Metabase를 ClickHouse에 연결하기

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

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

HTTPS를 선택하십시오. 연결 정보가 예시 curl 명령으로 표시됩니다.

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

1. plugins 폴더가 없다면 metabase.jar가 저장된 위치 아래에 하위 폴더로 생성합니다.

2. plugin은 clickhouse.metabase-driver.jar라는 이름의 JAR 파일입니다. 최신 버전의 JAR 파일은 https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest에서 다운로드하십시오.

3. clickhouse.metabase-driver.jar를 plugins 폴더에 저장합니다.

4. 드라이버가 올바르게 로드되도록 Metabase를 시작하거나 다시 시작합니다.

5. http://hostname:3000에서 Metabase에 접속합니다. 처음 시작하면 환영 화면이 표시되며 몇 가지 질문에 답해야 합니다. 데이터베이스를 선택하라는 메시지가 표시되면 "I'll add my data later"를 선택합니다:

1. 오른쪽 상단의 톱니바퀴 아이콘을 클릭한 다음 관리자 설정을 선택하여 Metabase 관리자 페이지로 이동합니다.

2. Add a database를 클릭합니다. 또는 Databases 탭에서 Add database 버튼을 선택할 수도 있습니다.

3. 드라이버가 정상적으로 설치되었다면 Database type 드롭다운 메뉴에 ClickHouse가 표시됩니다:

   

4. 데이터베이스의 Display name을 지정합니다. 이는 Metabase 설정이므로 원하는 이름을 사용하면 됩니다.

5. ClickHouse 데이터베이스의 연결 정보를 입력합니다. ClickHouse 서버가 SSL을 사용하도록 구성되어 있다면 보안 연결을 활성화합니다. 예시는 다음과 같습니다:

   

6. Save 버튼을 클릭하면 Metabase가 데이터베이스를 스캔하여 테이블을 찾습니다.

1. 오른쪽 상단의 Exit admin 버튼을 클릭하여 Admin settings를 종료합니다.

2. 오른쪽 상단에서 + New 메뉴를 클릭하면 질문을 만들고, SQL 쿼리를 실행하고, 대시보드를 만들 수 있음을 확인할 수 있습니다:

   

3. 예를 들어, 다음은 uk_price_paid라는 이름의 테이블에서 1995년부터 2022년까지 연도별 평균 거래 가격을 반환하는 SQL 쿼리입니다:

   

1. + New를 클릭하고 Question을 선택합니다. 데이터베이스와 테이블에서 시작해 질문을 만들 수 있습니다. 예를 들어, 다음 질문은 default 데이터베이스의 uk_price_paid라는 이름의 테이블에 대해 수행됩니다. 다음은 Greater Manchester county 내에서 town별 평균 가격을 계산하는 간단한 질문입니다:

   

2. Visualize 버튼을 클릭하여 결과를 표 형식 보기로 확인합니다.

   

3. 결과 아래에서 Visualization 버튼을 클릭하여 visualization을 막대 chart(또는 사용 가능한 다른 옵션)로 변경합니다: