java -jar metabase.jar를 실행하기만 하면 됩니다. Metabase는 JDBC 드라이버를 사용해 ClickHouse에 연결하며, 이 드라이버는 다운로드한 후 plugins 폴더에 넣어야 합니다:
목표
1
연결 정보 확인하기
HTTP(S)로 ClickHouse에 연결하려면 다음 정보가 필요합니다.
ClickHouse Cloud 서비스의 연결 정보는 ClickHouse Cloud 콘솔에서 확인할 수 있습니다.
서비스를 선택한 다음 Connect를 클릭하십시오.
curl 명령으로 표시됩니다.2
Metabase용 ClickHouse plugin 다운로드하기
-
plugins폴더가 없다면metabase.jar가 저장된 위치 아래에 하위 폴더로 생성합니다. -
plugin은
clickhouse.metabase-driver.jar라는 이름의 JAR 파일입니다. 최신 버전의 JAR 파일은 https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest에서 다운로드하십시오. -
clickhouse.metabase-driver.jar를plugins폴더에 저장합니다. - 드라이버가 올바르게 로드되도록 Metabase를 시작하거나 다시 시작합니다.
- http://hostname:3000에서 Metabase에 접속합니다. 처음 시작하면 환영 화면이 표시되며 몇 가지 질문에 답해야 합니다. 데이터베이스를 선택하라는 메시지가 표시되면 “I’ll add my data later”를 선택합니다:
3
Metabase를 ClickHouse에 연결하기
- 오른쪽 상단의 톱니바퀴 아이콘을 클릭한 다음 관리자 설정을 선택하여 Metabase 관리자 페이지로 이동합니다.
- Add a database를 클릭합니다. 또는 Databases 탭에서 Add database 버튼을 선택할 수도 있습니다.
- 드라이버가 정상적으로 설치되었다면 Database type 드롭다운 메뉴에 ClickHouse가 표시됩니다:
- 데이터베이스의 Display name을 지정합니다. 이는 Metabase 설정이므로 원하는 이름을 사용하면 됩니다.
- ClickHouse 데이터베이스의 연결 정보를 입력합니다. ClickHouse 서버가 SSL을 사용하도록 구성되어 있다면 보안 연결을 활성화합니다. 예시는 다음과 같습니다:
- Save 버튼을 클릭하면 Metabase가 데이터베이스를 스캔하여 테이블을 찾습니다.
4
SQL 쿼리 실행하기
- 오른쪽 상단의 Exit admin 버튼을 클릭하여 Admin settings를 종료합니다.
- 오른쪽 상단에서 + New 메뉴를 클릭하면 질문을 만들고, SQL 쿼리를 실행하고, 대시보드를 만들 수 있음을 확인할 수 있습니다:
-
예를 들어, 다음은
uk_price_paid라는 이름의 테이블에서 1995년부터 2022년까지 연도별 평균 거래 가격을 반환하는 SQL 쿼리입니다:
5
질문하기
-
+ New를 클릭하고 Question을 선택합니다. 데이터베이스와 테이블에서 시작해 질문을 만들 수 있습니다. 예를 들어, 다음 질문은
default데이터베이스의uk_price_paid라는 이름의 테이블에 대해 수행됩니다. 다음은 Greater Manchester county 내에서 town별 평균 가격을 계산하는 간단한 질문입니다: - Visualize 버튼을 클릭하여 결과를 표 형식 보기로 확인합니다.
- 결과 아래에서 Visualization 버튼을 클릭하여 visualization을 막대 chart(또는 사용 가능한 다른 옵션)로 변경합니다: