Metabase
Metabase
Apache Pinot를 Metabase와 통합해요.
이 안내는 Apache Pinot 커넥터로 Metabase를 설정하는 단계별 지침을 제공해요. 이 통합을 통해 Metabase 대시보드에서 직접 Apache Pinot에 저장된 데이터를 시각화하고 탐색할 수 있어요.
참고: 이것은 preview 버전이에요. 문제나 버그 보고는 Slack에 참여하거나 GitHub issue를 올려주세요.
코드는 https://github.com/startreedata/metabase-pinot-driver에 Apache 2 라이선스로 있어요.
출처: 문서
본문
사전 요구 사항
시스템에 다음 도구가 설치되어 있는지 확인하세요.
- Git
- Docker
- Node.js (버전 22+)
- Java (버전 17+)
- Clojure 1.12.1.1550
- NodeJS 22
- NPM 10
- Yarn 1.22
- Apache Pinot 1.3.0
- Metabase v0.55.7
QuickStart
로컬 실행
- Pinot 시작
간단하게 Pinot docker 이미지를 사용해 quickstart로 실행해요.
docker run -d --name pinot-quickstart -p 9000:9000 -p 8000:8000 -p 8080:8080 apachepinot/pinot:latest QuickStart -type MULTI_STAGE
- Metabase 다운로드
Metabase 릴리스 페이지로 가서 릴리스 jar를 찾으세요.
이 quickstart는 Metabase v0.55.7을 사용해요.
JAR 다운로드: https://downloads.metabase.com/v0.55.7.x/metabase.jar
mkdir -p /tmp/metabase
cd /tmp/metabase
wget https://downloads.metabase.com/v0.55.7.x/metabase.jar
- Pinot 드라이버 다운로드
Pinot 플러그인은 https://github.com/startreedata/metabase-pinot-driver/releases에서 릴리스돼요.
이 QuickStart는 Pinot Driver v1.1.0을 사용해요.
mkdir -p /tmp/metabase/plugins
cd /tmp/metabase/plugins
wget -O pinot.metabase-driver.jar https://github.com/startreedata/metabase-pinot-driver/releases/download/v1.1.0/pinot.metabase-driver-v1.1.0.jar
- Pinot 플러그인으로 Metabase 시작
cd /tmp/metabase
java --add-opens java.base/java.nio=ALL-UNNAMED -jar metabase.jar
이제 모든 것이 올라와야 하며 로그에서 pinot 플러그인이 로드된 것을 확인할 수 있어요.
Metabase가 올라오면 http://localhost:3000으로 가서 탐색하세요.
로그인 후 오른쪽 사이드 바를 클릭해 Pinot 데이터베이스를 추가할 수 있어요.
구성이 완료되면 Metabase가 자동으로 일부 탐색(exploration)을 생성할 거예요.
Docker Compose
아래 Dockerfile과 docker-compose.yml을 /tmp/metabase 같은 디렉토리에 복사하세요.
Dockerfile:
FROM metabase/metabase:v0.55.7
RUN mkdir -p /plugins && \
curl -L -o /plugins/pinot.metabase-driver.jar \
https://github.com/startreedata/metabase-pinot-driver/releases/download/v1.1.0/pinot.metabase-driver-v1.1.0.jar
ENV MB_PLUGINS_DIR=/plugins
docker-compose.yml:
services:
metabase:
build: .
container_name: metabase-pinot
ports:
- "3000:3000"
environment:
- MB_PLUGINS_DIR=/plugins
volumes:
- metabase_data:/metabase-data
restart: unless-stopped
volumes:
metabase_data:
docker compose up을 실행해 모든 것을 시작하세요.
고급 옵션
인증 헤더
사용자는 고급 옵션을 확장한 다음 Authentication header를 활성화해 이를 켤 수 있어요.
지원되는 Auth Token Type은 Basic 또는 Bearer예요.
Auth Token Value는 관리자의 문자열이에요.