Metabase二次开发教程-01-准备工作

dazdata

一、开发概述

Metabase采用前后端分离的方式构建，前端使用react搭建页面，后端使用clojure提供REST API接口，详见 API Document；
Metabase提供了官方文档Developers Guide，对开发环境和运行方式进行了简要说明；
本文档主要侧重于Clojure部分，前端涉及技术栈比较主流，网上各种文章分析也很全面，就不重复讨论了。

二、Clojure学习

Clojure比较冷门，网上学习资料也比较少，因此以官方文档和英文资料为主，一下为一些学习资源：

中文基础教程主要涵盖了基本语法的教程，内容不多，适合起步阅读；
官方基础教程同样是基础语法教程，内容不多，英文版；
Clojars Clojure的依赖仓库，类似于java的Maven Repository；
ClojureDocs Clojuer语法检索，比如输入 map 会检索出map的用法和多个使用示例，非常好用
4Clojure 包含156道Clojure入门练习题，对于快速掌握语法很有帮助

三、clojure开发配置

官方网站对Clojure安装进行了说明，详见Getting Started
个人总结的安装步骤包括：

在Mac上安装Clojure建议使用Homebrew，一键安装简单方便。
Homebrew官方网站有详细的安装指引，但出于大家都懂的原因，国内没办法按流程安装，网上能搜到各种攻略，但第一次配置还是比较艰难的，推荐使用金牛肖马分享的安装脚本，流程清晰操作简单，链接 Homebrew国内安装
安装Leiningen，可以理解为可以理解为Clojure用的Maven，必不可少的包管理工具，也是Clojure官网推荐的，Leiningen官网

Leiningen官网推荐的安装方式是下载脚本并在本地运行，脚本运行时要多次访问github，出于大家都懂的原因，需要先解决github访问的问题；

github访问不了的主要方式是DNS地址污染，因此可以通过在本地hosts文件中绑定IP地址的方式解决，网上教程也很多，自行百度即可；
请注意github的IP在2020年中变化过一次，因此早期的教程可能不起作用，最好是自己先手动查一下最新的IP地址

安装Cursive，运行在Idea中的Clojure语言插件，直接在Idea中搜索安装即可，使用教程可查阅Cursive官网

网上有些文档会建议安装cursive和leiningen两个插件，其实只安装cursive就够了，安装了leiningen反而会冲突报错；
Clojure项目在Idea中若直接通过Idea中File → Open的方式打开会报错，因为Cursive需要在第一次导入项目时先建索引，因此要通过 File → New → Project from Existing Sources 的方式导入；
直接在Idea中新建的项目和已经建好索引的项目可以直接打开，不需要每次打开时都重建索引；
右键点击 project.clj 文件，选择 Run ‘REPL for XXX’ 将在Idea中运行REPL，优势是可以使用快捷键实时将代码导入到REPL中，非常灵活
Ideal屏幕右下方 structural style 建议选择 Parinfer，自动匹配括号，极其方便

四、常用指令

lein使用
leiningen常用命令(需要于project.clj文件所在目录下执行)

lein deps   # 手动下载项目依赖，若跳过该指令运行项目前也会自动下载依赖
lein run 以 project.clj  # 中配置的 :main 作为运行入口，运行 -main 方法
lein ring server  # 执行lein-ring插件配置，运行服务端
lein new project_name # 按照默认模版，创建名为 project_name 的新任务

五、开发运行

官方推荐：yarn build-hot 启动前端， lein run 启动后端
前后端均启动后，访问 http://localhost:3000/ 可进行页面操作（注意不是访问8080）
metabase默认使用内嵌h2存储元数据，但推荐在生产环境迁移到MySQL或PostgreSQL

若希望将h2数据迁移到MySQL，可参阅官方文档，启动代码如下：

MB_DB_TYPE=mysql MB_DB_HOST=172.0.0.1 MB_DB_PORT=3306 MB_DB_USER=username MB_DB_DBNAME=metabase MB_DB_PASS=password lein run load-from-h2

即使换成迁移，下次启动时仍会默认采用h2数据库，使用MySQL数据库仍需要配置参数：

MB_DB_TYPE=mysql MB_DB_HOST=172.0.0.1 MB_DB_PORT=3306 MB_DB_USER=username MB_DB_DBNAME=metabase MB_DB_PASS=password lein run

转载自：https://blog.csdn.net/weixin_43821438/article/details/111152343