FineReport连接MaxCompute

MaxCompute支持您将MaxCompute项目数据接入FineReport,您通过简单拖拽式操作便可制作中国式复杂报表。本文为您介绍如何通过MaxCompute JDBC驱动,连接FineReport和MaxCompute项目,并进行报表分析。

背景信息

FineReport是帆软软件有限公司自主研发的企业级Web报表工具,秉持零编码的理念,易学易用、功能强大,通过简单的拖拽操作便可制作中国式复杂报表,轻松实现报表的多样化展示、交互分析、数据录入、权限管理、定时调度、打印输出、门户管理和移动应用等需求。更多FineReport信息,请参见FineReport

前提条件

在执行操作前,请确认您已满足如下条件:

操作流程

FineReport连接MaxCompute的操作流程如下:

  1. 步骤一:放置MaxCompute JDBC驱动

    将MaxCompute JDBC驱动JAR包放置于FineReport的驱动目录下,后续FineReport可通过该驱动访问MaxCompute项目。

  2. 步骤二:连接FineReport和MaxCompute

    通过配置连接参数,连接FineReport及MaxCompute项目。

  3. 步骤三:使用FineReport查询及分析数据

    在FineReport上访问MaxCompute项目数据并进行可视化分析。

步骤一:放置MaxCompute JDBC驱动

  1. 可选:如果FineReport的安装目录%FineReport%\lib下存在xercesImpl.jar,您需要在登录FineReport的状态下,下载xercesImpl-2.11.0.jar,并替换掉xercesImpl.jar

    如果目录下没有xercesImpl.jar,请忽略本步骤,进行下一步操作。

  2. 将下载的MaxCompute JDBC驱动JAR包odps-jdbc-3.2.9-jar-with-dependencies.jar放置在FineReport的安装目录%FineReport%\webapps\webroot\WEB-INF\lib下。

    放置目录

步骤二:连接FineReport和MaxCompute

  1. 启动FineReport,进入FineReport界面。

  2. 在顶部菜单栏,选择服务器 > 定义数据连接

    定义数据连接
  3. 定义数据连接对话框,单击添加图标,选择JDBC,配置下表所列参数信息。

    JDBC连接

    参数

    说明

    数据库

    在下拉列表选择Others

    驱动器

    用于连接MaxCompute项目的驱动程序。固定取值为com.aliyun.odps.jdbc.OdpsDriver,您需要手动输入,不支持在下拉列表选择。

    用户名

    具备目标MaxCompute项目访问权限的AccessKey ID。

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

    密码

    AccessKey ID对应的AccessKey Secret。

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

    URL

    连接MaxCompute项目的URL。格式为jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true|false}]。配置时删除<>符号。参数说明如下:

    • <MaxCompute_endpoint>:必填。MaxCompute项目所属区域的Endpoint。

      各地域的Endpoint信息,请参见Endpoint

    • <MaxCompute_project_name>:必填。待连接的目标MaxCompute项目名称。

      此处为MaxCompute项目名称,非工作空间名称。您可以登录MaxCompute控制台,左上角切换地域后,即可在项目管理页签查看到具体的MaxCompute项目名称。

    • interactiveMode:可选。查询加速功能开关。

      如果您需要启用查询加速功能,在URL后追加&interactiveMode=true配置即可。更多查询加速功能信息,请参见查询加速

    编码

    建议选择UTF-8

  4. 在参数信息上方单击测试连接,连接成功后依次单击确定,完成FineReport和MaxCompute连接。

    如果连接出现问题,请参见数据连接FAQ测试连接

    说明

    测试连接时,建议单击高级区域的连接池属性,设置获取连接前校验值为,否则连接会比较慢。

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

在FineReport中,您可以从已经连接的MaxCompute项目中查询及分析数据,FineReport会将数据以二维表的形式保存并显示在数据集管理面板处。您可以执行如下操作,操作详细指导,请参见FineReport帮助

  • 查看所有表

    在FineReport界面,单击添加图标,选择数据库查询后,选择步骤二中创建的数据连接,FineReport会自动加载MaxCompute项目的所有表。

    查看所有表
  • 查看表结构

    在FineReport界面,单击添加图标,选择数据库查询后,选择步骤二中创建的数据连接,编写SQL查询语句后,您可以在模板数据集区域查看到表结构信息。

    查看表结构
    说明

    如果操作过程中出现“数据集配置错误”报错,解决方案请参见注意事项

  • 查看表数据

    在FineReport界面,单击添加图标,选择数据库查询后,选择步骤二中创建的数据连接,编写SQL查询语句后,您可以单击预览图标查看到表数据信息。

    查看表数据
  • 可视化分析数据

    创建数据库查询后,您可以在右侧单击图标图标,插入元素并配置元素属性,即可根据实际业务诉求开展数据分析。

    可视化分析数据