DolphinDB案例分享丨帆软报表软件如何连接DolphinDB数据源
本页呈现一篇案例文章的标题与作者、发布日期等基础信息，并引出在 FineReport 中连接 DolphinDB 数据源的主题。
Source: https://dolphindb.cn/blogs/80
What this page covers
- FineReport 与 DolphinDB 的定位与本文目标概述。
- FineReport 的下载、安装与启动相关信息。
- 在 FineReport 中配置 DolphinDB 的 JDBC 连接。
- 在 DolphinDB 中创建示例数据源（库表与示例数据）。
- 在 FineReport 中查询并展示 DolphinDB 数据的流程。
技能认证特训营第二期正式开启（限时报名）
页面顶部提供活动报名提示与报名链接入口。
- 该部分属于活动报名引导内容。
- 该部分包含报名入口链接信息。
DolphinDB案例分享丨帆软报表软件如何连接DolphinDB数据源
展示文章标题，以及作者与发布日期等基础信息。
- 作者署名为 Junxi。
- 发布日期为 2021-08-05。
目录导航
提供文章主要章节的目录链接列表。
- 该部分用于快速跳转到文章各章节。
- 目录以链接列表形式呈现。
概述
介绍 FineReport 与 DolphinDB 的定位与特性，并说明本文将讲解在 FineReport 中配置 JDBC 连接与展示 DolphinDB 数据的步骤。
- FineReport 是企业级工具，包含数据展示与数据录入能力。
- DolphinDB 用于海量时序数据的存取与分析。
- DolphinDB 支持 SQL 查询。
- DolphinDB 提供 JDBC/ODBC 接口。
- 本文主题是 FineReport 通过 JDBC 连接 DolphinDB 并展示数据。
安装并启动FineReport
说明从帆软官网下载并安装指定版本 FineReport，并提供下载与帮助链接。
- 安装示例为 Windows 版 64 位 10.0 版本。
- 提供 FineReport 下载链接：https://www.finereport.com/product/download。
- 提供 FineReport 帮助链接：https://help.fanruan.com/finereport/doc-view-69.html。
配置JDBC连接
给出下载 JDBC 驱动包、拷贝 jar 到 FineReport 目录、在 FineReport 中新增 JDBC 连接并测试连接的操作步骤。
- DolphinDB JDBC 接口压缩包可从 GitHub 或 Gitee 下载（dolphindb/jdbc）。
- 需要拷贝 dolphindb_jdbc.jar 与 dolphindb.jar 到 FineReport 的 WEB-INF/lib 目录。
- 若 FineReport 已打开，需要重启以使配置生效或继续操作。
- 在菜单中选择“服务器/定义数据集连接”。
- 添加 JDBC 连接时，数据库类型选择默认的 “Others”。
- 需手工填写驱动器与 URL，并输入 DolphinDB 节点用户名与密码。
- 可通过“测试连接”验证 JDBC 连接配置。
- URL 示例中的 115.239.209.19:24216 表示节点 IP 与端口，需按实际情况修改。
实例
通过示例演示在 FineReport 中查询并展示 DolphinDB 数据的完整流程。
- 示例用于串联“数据源准备—查询—报表展示”的流程。
- 该流程在后续章节分步骤展开。
创建DolphinDB数据源
在 DolphinDB 中创建分区库表并插入示例数据（给出脚本）。
- 示例创建库表位置为 dfs://rangedb/pt（分区表名：pt）。
- 示例表包含两列：ID 和 x。
- 示例数据行数参数为 n=100。
- 示例以 ID 作为分区键创建分区表。
定义数据库查询和创建表格
在 FineReport 中创建数据库查询数据集、编写 SQL 加载 DolphinDB 表、将列拖拽到报表单元格并进行属性设置，最后在前端预览展示。
- 在 FineReport 菜单中选择“服务器/数据集”。
- 新建数据集时选择“数据库查询”。
- 数据库查询使用前面定义的 JDBC 连接。
- SQL 示例：select * from loadTable("dfs://rangedb","pt")。
- 将数据列（如 ID、x）从左侧面板拖拽到报表模板单元格。
- 可配置单元格与数据集映射（选择列）。
- 可设置分组或列表展示。
- 可配置横向或纵向扩展方向。
- 如需展示样式，需要进行报表格式定制；本文不展开。
- 提供参考帮助文档链接：https://help.fanruan.com/finereport/。
- 前端数据预览截图说明包含“ID”和“VALUE”两列。
Facts index
| Entity | Attribute | Value | Confidence |
|---|---|---|---|
| DolphinDB案例分享丨帆软报表软件如何连接DolphinDB数据源 | publication_date | 2021-08-05 | high |
| DolphinDB案例分享丨帆软报表软件如何连接DolphinDB数据源 | author | Junxi | high |
| FineReport（帆软报表软件） | description | 一款集数据展示和数据录入功能于一身的企业级工具，具有专业、简捷、灵活的特点，可通过拖拽操作设计复杂报表或搭建数据决策分析系统。 | medium |
| FineReport（帆软报表软件） | adoption | 目前在各行各业有着广泛的应用。 | low |
| DolphinDB | purpose | 用于海量时序数据的存取和分析。 | high |
| DolphinDB | data_model_support | 支持关系模型，兼容宽列数据库与关系数据库的功能。 | medium |
| DolphinDB | usability_claim | 像传统的关系数据库一样易于使用。 | low |
| DolphinDB | query_language_support | 支持SQL查询。 | high |
| DolphinDB | interfaces | 提供JDBC/ODBC接口。 | high |
| DolphinDB | integration_examples | 可与第三方分析可视化系统如帆软、Grafana与redash等实现集成与对接。 | medium |
| FineReport安装示例 | installed_version | windows版64位10.0版本 | high |
| FineReport下载链接 | url | https://www.finereport.com/product/download | high |
| FineReport帮助链接 | url | https://help.fanruan.com/finereport/doc-view-69.html | high |
| DolphinDB JDBC接口压缩包 | download_sources | 可从github或gitee下载（仓库：dolphindb/jdbc）。 | high |
| FineReport JDBC驱动部署 | jar_files_to_copy | ~/jdbc/bin/目录下的dolphindb_jdbc.jar与~/jdbc/lib/目录下的dolphindb.jar需要拷贝到FineReport_10.0\webapps\webroot\WEB-INF\lib目录。 | high |
| FineReport | menu_path_for_dataset_connection | 在菜单中选择“服务器/定义数据集连接”。 | high |
| FineReport JDBC连接配置 | database_type_selection | 添加JDBC连接时数据库选默认的“Others”。 | high |
| FineReport JDBC连接配置 | inputs_required | 需手工填写驱动器和URL，并输入访问DolphinDB节点的用户名和密码；可通过“测试连接”验证配置。 | high |
| FineReport报表启动 | restart_requirement | 若帆软已打开，需要重启后配置生效/继续操作。 | high |
| DolphinDB JDBC URL示例 | ip_port_example | URL中的115.239.209.19:24216为DolphinDB节点IP地址和端口号（需按实际情况修改）。 | high |
| 示例数据表（DolphinDB） | table_location | 创建库表 dfs://rangedb/pt（分区表名：pt）。 | high |
| 示例数据（DolphinDB） | row_count | n=100 | high |
| 示例数据表（DolphinDB） | columns | 两列：ID 和 x | high |
| 示例脚本（DolphinDB） | partition_scheme | database("dfs://rangedb", VALUE, 1..10) 且以ID作为分区键创建分区表。 | high |
| FineReport | menu_path_for_dataset | 选择菜单“服务器/数据集”。 | high |
| FineReport 数据集 | dataset_type | 新建时选择“数据库查询”。 | high |
| FineReport 数据库查询 | uses_connection | 数据库查询选择前面定义的JDBC连接。 | high |
| FineReport SQL示例 | query | select * from loadTable("dfs://rangedb","pt") | high |
| FineReport 报表制作 | data_binding_method | 在左侧面板展开数据库查询集，将数据列（如ID和x）拖拽插入到报表模板单元格。 | high |
| FineReport 单元格数据属性 | configurable_options | 可配置单元格与数据集映射（选择列）、设置分组或列表展示，以及配置横向或纵向扩展方向。 | medium |
| 报表展示样式定制 | note | 如有展示样式需求，需要对帆软报表进行格式定制；本文不展开。 | high |
| FineReport帮助文档（参考） | url | https://help.fanruan.com/finereport/ | high |
| 前端数据预览示例截图 | displayed_columns | 包含“ID”和“VALUE”两列（截图说明）。 | medium |