文档

Metabase连接MaxCompute

更新时间:

MaxCompute提供Metabase Driver(驱动)插件,支持您使用开源的商业智能工具Metabase连接MaxCompute项目,从而理解数据、分析数据,进行数据查询并获取格式化结果(图形化视图),以数据驱动决策。

版本说明

  • Metabase Driver目前处于Preview阶段,相关功能正在持续优化完备中。

  • 本驱动基于Metabase V0.50版本开发。如发现与特定版本不兼容或其他任何问题,可以通过您的专属钉群或MaxCompute开发者社区群(钉钉群号:11782920)联系我们。

前提条件

  • 已下载并安装Java 11或更高版本的JDK,JDK官网下载地址请参见JDK官网

  • 已创建MaxCompute项目,详情请参见创建MaxCompute项目

  • 已单击odps-jdbc下载最新版本的MaxCompute JDBC驱动odps-jdbc-jar-with-dependencies.jar

    说明

    ODPS JDBC需要为V3.7.0或以上版本。

步骤一:启动Metabase

  1. 下载Metabase JAR和Metabase MaxCompute驱动。

  2. 新建一个文件目录(例如metabase_mc_dir),并将metabase.jar移动到该目录下。

  3. 在metabase_mc_dir目录内创建一个名为plugins的子目录,并将maxcompute.metabase-driver.jarodps-jdbc-jar-with-dependencies.jar移动到plugins目录中。

  4. 启动Metabase。

    进入metabase_mc_dir目录下,运行java -jar metabase.jar命令启动Metabase。

    出现如下信息,表示Metabase启动成功:

    024-08-29 16:17:53,745 INFO metabase.task :: Task scheduler started
    2024-08-29 16:17:53,746 INFO metabase.core :: Metabase Initialization COMPLETE in 27.7 s
    2024-08-29 16:17:53,764 INFO task.refresh-slack-channel-user-cache :: Slack is not configured, not refreshing slack user/channel cache.

    若启动过程中显示端口被占用,您可参考Customizing the Metabase Jetty webserver在本地增加环境变量MB_JETTY_PORT,修改当前端口(默认端口为3000),并重新启动Metabase。

    Metabase启动成功后,您可在浏览器中通过http://localhost:<port>(port为端口信息)访问Metabase初始化界面。

步骤二:连接Metabase和MaxCompute

  1. 在Metabase初始化界面中,根据页面提示进行Metabase初始配置。添加数据时可参考如下方法添加MaxCompute数据库:

    说明
    • 您也可在添加你的数据区域,选择我之后再添加数据。初始化完成之后,可在Metabase页面中参考Adding and managing databases方式添加MaxCompute数据库。

    • Metabase初始化方法请参见setting-up-metabase

    1. 添加你的数据区域,搜索MaxCompute数据库,并单击进入。

    2. 根据下表配置参数:image

      参数名

      描述

      显示名称

      必填,MaxCompute数据库在Metabase中的显示名称。

      Project

      必填,待访问的目标MaxCompute项目名称。

      Endpoint

      必填,MaxCompute服务的连接地址。

      您需要根据创建MaxCompute项目时选择的地域以及网络连接方式配置Endpoint。各地域及网络对应的Endpoint值,请参见Endpoint

      AccessID

      必填,阿里云账号或RAM用户的AccessKey ID。

      您可以进入AccessKey管理页面获取AccessKey ID。

      AccessKey

      必填,AccessKey ID对应的AccessKey Secret。

      timezone

      可选,指定时区,将影响Metabase展示时间类型的值,默认为Asia/Shanghai。

      时区详情请参见时区列表

    3. 单击连接数据库

  2. 在Metabase页面的左侧导航栏单击浏览 > 数据库

  3. 数据库页面单击上述已创建的MaxCompute数据库显示名称,即可加载出目标MaxCompute项目中的表信息。image

步骤三:使用Metabase查询及分析数据

在Metabase操作界面,您可以基于新创建的MaxCompute数据库,查询MaxCompute项目数据及分析数据。成功添加MaxCompute数据库后,您可以执行如下操作,详细指导请参见Metabase documentation

  • 查看所有表

    数据库页面查看MaxCompute项目的所有表信息。image

  • 查看表结构

    数据库页面单击目标表后的image图标,并选择表中字段页签后,即可查看表结构。image

  • 查看表数据

    数据库页面单击进入目标表,即可查看相应的表数据。

    您也可在页面右上角单击查询搜索框,然后在操作区域单击新SQL查询,选择数据库后,即可通过编写SQL代码查看表数据并保存。image

  • 可视化分析数据

    参照查看表数据流程自定义SQL创建数据表后,即可根据实际业务诉求创建仪表板并配置参数属性开展数据分析,详情请参见Metabase Dashboard