Metabase Documentation
这里主要是 metabase 的部署和使用方法,以及相关的组件的使用方法。
我正在打造一个中文环境下 Metabase 交互的社群,如果你有任何关于 Metabase 的问题,请联系我们:
Metabase 中文交流 https://t.me/metabase_zh
Installation
Metabase 的安装方式有三种:
- 以 Jar 包的形式,在本地运行,只需要简单的步骤即可 (本文)
- 以 Docker 容器的形式,部署到服务器上
以 Jar 的方式来运行相对简单,对环境依赖也是比较少,只要的电脑上有 JDK 就可以了。
检查 Java 环境
java -version
=> java version "1.8.0_311"
=> Java(TM) SE Runtime Environment (build 1.8.0_311-b11)
=> Java HotSpot(TM) 64-Bit Server VM (build 25.311-b11, mixed mode)
Metabase 要求 Java 8 及以上,如果你的环境不支持,请先升级
获取 Metabase 的 Jar 包
通过上方这个链接,可以很快的获取到 Metabase 的最新版本的 Jar 包
启动 Metabase
java -jar metabase.jar
通过一个简单的命令,就可以启动 Metabase 了,这个命令会自动检查环境,如果环境没问题,就会自动启动 Metabase 了。
生产环境的 MetaBase 路径是 /data/product/metabase/
成功启动后,Metabase 会运行在 3000 端口
以后台方式运行 Metabase
nohup java -jar metabase.jar > metabase.log 2>&1 &
日志文件会保存在本地的 metabase.log 文件中,如果你想查看 Metabase 的日志,可以使用 tail -f metabase.log 来查看。
Configuration
配置 Metabase 的数据库
Metabase 默认的采用的是 H2 的作为数据库存储,会存放在程序运行目录下的 data
目录下;但对于在正式环境中启用 Metabase,我们建议使用 MySQL 来作为数据库存储。
而指定 Metabase 的数据库配置,可以很方便的加载到系统的默认环境中:
vim ~/.bashrc
# update metabase config at .bashrc
export MB_DB_TYPE=mysql
export MB_DB_DBNAME=metabase
export MB_DB_PORT=3306
export MB_DB_USER=
export MB_DB_PASS=
export MB_DB_HOST=
export MB_DB_CONNECTION_URI="mysql://MB_DB_HOST:MB_DB_PORT/MB_DB_DBNAME?user=MB_DB_USER&password=MB_DB_PASS"
export JAVA_TIMEZONE=Asia/Shanghai
配置 Metabase 的 Nginx
通过配置 Metabase 的 Nginx,可以让 Metabase 在网站上运行,这样可以开放外部服务给使用者
对 Nginx 的配置,比较简单,可以参考这个文档:
server {
listen 443 ssl;
server_name example.com;
root /var/www/example.com/public;
# reverse proxy
location /mb/ {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $Host;
}
}
overseas-metabase 的 配置文件放在 /etc/nginx/config.d/leyan.core 下,在 80.conf 内 引用
配置 Metabase 的 ClickHouse 插件
Metabase 官方支持数据库 https://www.metabase.com/docs/latest/administration-guide/01-managing-databases.html#officially-supported-databases
Metabase 默认支持非常丰富数据库驱动,这些都会预置在 Jar 内,例如 MySQL、Oracle、SQL Server;但是 ClickHouse 不在其中,所以我们需要独立进行安装。
ClickHouse 驱动:https://github.com/enqueue/metabase-clickhouse-driver#readme=
- 下载 合适的 驱动版本,放在 Metabase 的目录下的 plugin 文件夹下
- 重新启动 Metabase 即可
- 在 Metabase 的数据库管理中新增数据库,选择类型为 ClickHouse
Tips
1. 如何重启 Metabase ?
直接杀掉进程即可,如果为了以后方便,可以将下述命令保存为 stop.sh 放在目录下,后续直接执行
APP_NAME="metabase"
ps aux | grep python | grep ${APP_NAME} | awk '{print $2}' | xargs kill -9