1. 概述
1.1 应用场景
MongoDB 作为一款非常流行的 NoSQL 数据库,越来越被广泛地使用,但是帆软报表中 JDBC 和 JNDI 都无法连接 MongoDB 进行取数,安装该插件可以连接 MongoDB 数据库。
有关 MongoDB 的介绍和使用方法可以参阅MongoDB官方帮助文档的说明。
1.2 功能介绍
设计器菜单栏服务器>定义数据连接处会新增MongoDB类型的数据连接方式。
定义好数据连接后,数据集管理面板处新增MongoDB明细数据集和MongoDB聚合数据集。
注:目前只支持在设计器中定义 MongoDB 数据连接,不支持在决策平台进行连接。
2. 操作步骤
2.1 安装插件
点击下载插件:mongodb数据库
设计器插件安装方法参照:设计器插件管理
服务器安装插件方法参照:服务器插件管理
2.2 定义数据连接
插件安装后,点击设计器菜单栏服务器>定义数据连接,新建一个MongoDB类型的数据连接,根据实际场景填写数据库连接信息,点击测试连接,弹出连接成功对话框后,点击确定保存即可。
2.3 添加 MongoDB 明细数据集
左下角数据集管理面板处添加一个MongoDB明细数据集,打开数据库查询面板,填写相关查询信息后,即可预览到 MongoDB 数据库表中的数据。
下面以示例分别说明如何查询 MongoDB 中简单型数据、数组型数据、对象型数据这三种不同的数据类型。
1)简单型数据
以查询 MongoDB 数据库 test 中的表 jaindanxing 为例,该表中的数据如下图所示:
新建 MongoDB 明细数据集mongo1,如下图填写数据库查询信息。
注:简单型数据没有维度可以不用填写,查询条件、过滤条件、排序条件根据需求填写。
点击数据库查询面板的预览按钮,结果如下图所示:
2)数组型数据
MongoDB 是文档型数据库,每个文档( doc )表示一条数据记录。相比于关系型数据库的行记录 row 只能使用简单型数据,doc 能够使用复杂的数组型数据,可以将 doc 内嵌到数组中。
MongoDB 的数组是一系列元素的集合,使用中括号 [] 表示数组,例如:[1,2,3] 中的元素是整数值,[{name:"t5"}, {name:"t7"}],[ {name:"t5", age:21}, {name:"t7", age:22} ]中的元素是 doc。
以查询 MongoDB 数据库 test 中的表 shuzuxing 为例,该表中的数据如下图所示:
新建 MongoDB 明细数据集mongo2,不填写任何查询信息,直接查出该表中的所有数据。
点击数据库查询面板的预览按钮,结果如下图所示:
3)对象型数据
以查询 MongoDB 数据库 test 中的表 duixiangxing 为例,该表中的数据如下图所示:
新建 MongoDB 明细数据集mongo3,不填写任何查询信息,直接查出该表中的所有数据。
点击数据库查询面板的预览按钮,结果如下图所示:
也可以根据维度来展示数据,如下图填写好维度信息,根据维度筛选数据。
点击数据库查询面板的预览按钮,结果如下图所示:
2.4 添加 MongoDB 聚合数据集
1)左下角数据集管理面板处添加一个MongoDB聚合数据集,打开数据库查询面板,填写相关查询信息后,即可预览到 MongoDB 数据库表中的数据。
注:仅 V9.0 及之后版本支持聚合数据集
2)以查询 MongoDB 数据库 test 中的表 juhe 为例,该表中的数据如下图所示:
新建 MongoDB 明细数据集mongo4,数据库查询面板下拉选择聚合操作符,填写相应的值。
注:这里是根据作者计算他所写的文章数。
点击数据库查询面板的预览按钮,结果如下图所示:
3. 注意事项
3.1 ISO 标准时间格式
在 MongoDB 中时间要转换为 ISO 标准格式,如下图所示,查询日志中 2017-2-17 以前的记录:
3.2 时间查询的时区问题
1)问题描述
查询 MongoDB 数据库表中的时间时,有时会出现设计器和 shell 工具查询出来结果不一致的问题。
例如下图所示的查询语句:
设计器中查询出的结果:
shell 工具查询出的结果:
2)原因分析
用户录入时间数据的语句为:"REAL_SEND_DATETIME" : ISODate("2019-08-31T12:50:11.000Z"),该语句使用 ISODate() 函数插入了 GMT 时间,设计器查到的数据转换为本地时间会加上8个小时,这就导致了数据和查询差异。
3)解决方案
录入数据时使用了 GMT 时间,设计器中查询时使用'REAL_SEND_DATETIME': {$gt: ISODate('2019-01-01T00:00:00.000Z')}就可以得到正确的结果了,但是展示时候会转换为本机的时间。
注:有关 MongoDB 中日期格式的使用可以查看官方文档的介绍:Date()