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驱动。

   • 单击Metabase下载最新版本的metabase.jar。

   • 单击Metabase MaxCompute Driver下载驱动JAR包maxcompute.metabase-driver.jar。

2. 新建一个文件目录（例如metabase_mc_dir），并将metabase.jar移动到该目录下。

3. 在metabase_mc_dir目录内创建一个名为plugins的子目录，并将maxcompute.metabase-driver.jar和odps-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. 根据下表配置参数：

      参数名	描述
      显示名称	必填，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项目中的表信息。

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

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

• 查看所有表

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

• 查看表结构

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

• 查看表数据

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

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

• 可视化分析数据

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