1 概述
MongoDB是一个基于分布式文件存储的数据库。由C++语言编写。旨在为WEB应用提供可扩展的高性能数据存储解决方案。MongoDB是一个介于关系数据库和非关系数据库之间的产品,是非关系数据库当中功能最丰富,最像关系数据库的。
本文介绍如何在Smartbi中连接 MongoDB 数据库。版本信息如下
驱动版本 | Smartbi版本 |
---|---|
mongo-java-driver-3.4.2 | Smartbi V10 |
Smartbi支持的MongoDB数据类型如下:
数据类型 | 说明 | 备注 |
---|---|---|
INTEGER | 整数 | 固定格式的简单结构,且子元素结构必须相同 |
decimal | 精确值类型 | |
Double | 双精度浮点型 | |
Date(TIMESTAMP) | 日期 | |
String(VARCHAR) | 字符串 | |
Boolean | 布尔型 | |
json | 轻量级的数据交换格式 | |
Array | 数组 |
2 数据连接
2.1 配置信息
驱动程序类 | 连接字符串 | 驱动程序存放目录 | 支持数据库版本 |
---|---|---|---|
smartbi.jdbc.MongoDriver | jdbc:smartbi:mongo:<server>:<port>/<dbName> | 自定义 | MongoDB 3.4.10 |
1)连接字符串主要信息说明:
- <servername>:数据库的地址;
- <port>:数据库端口;
- <dbName>:数据库名称;
以上信息一般向数据库管理员获取。
2)添加自定义驱动方法:
a、首先进入到<Smartbi_PATH>\Tomcat\bin\dynamicLibraryPath文件夹下,手动添加mongodb文件夹。
b、然后进入mongodb文件夹下,添加mongodb驱动(驱动包可以从数据库官网获取或向数据库管理员获取)。
c、最后在数据连接时需要点击自定义选项,选择mongodb。
2.2 连接步骤
1)登录Smartbi企业报表分析平台,选择 数据连接>NoSQL数据库 ,点击 MongoDB 图标进入数据库连接界面。如下图所示:
2)根据配置信息,输入数据库对应的信息。如下图所示:
说明:
a、名称是数据连接名称,用户可以自定义,不可为空。
b、用户名和密码是连接字符串中配置的数据库的连接用户名和密码,可为空,一般可以联系数据库管理员获取。
① 如果使用MongoDB作为业务库时,需要在连接字符串后加上“?authenticationDatabase=test”
例如:jdbc:smartbi:mongo:10.10.204.155:27017/test?authenticationDatabase=test
② 如果使用MongoDB作为认证库时,需要在连接字符串后加上“?authenticationDatabase=admin”
例如:jdbc:smartbi:mongo:10.10.204.155:27017/test?authenticationDatabase=admin
2.3 测试连接
1)信息正确输入后,点击 测试连接 ,若出现如下图的 测试通过 弹出框,则表示可以成功连接上数据库。如下图所示:
2)测试连接成功后,点击右下角的 保存 按钮,选择数据源的保存位置,保存成功后,该数据连接即添加成功。如下图所示:
3)数据库连接成功后,可以参考快速入门的使用方式查看数据。
2.4 使用说明
MongoDB数据源为NOSQL数据库,仅支持创建原生SQL数据集、抽取模式下数据模型的SQL查询
数据集处理需通过antlr等第三方工具包统一解析sql语句的语法树,因为mongo不是使用sql语法,目前产品只能解析处理部分常用的MongoDB查询指令,其他指令需要在find之前前面加上return ,通过eval指令执行runCommand脚本函数支持。
使用时需注意如下:
1)目前直接支持的指令关键字有:(即find命令如果只使用了下面关键字不需要在前面加return )
常规指令:
find、getCollection、limit、sort、projection、skip、toArray等;
查询条件:
$gt、$gte、$lt、$lte、$eq、$neq、$in、$nin、$and、$or、$nor、$not、$regex等;
正则表达式部分字符(如字符^)与expression.antlr冲突,find查询支持直接使用正则表达式和使用new RegExp对象,但是不能包含冲突字符。如果是比较复杂的正则表达式建议添加return使用脚本查询。
2)目前支持的数据类型
数值、字符、布尔、日期、正则、内嵌文档、常规数组;
产品只支持MongoDB规整结构的数据结构,即要求返回每行的数据结构是一样,每行不一样只解析第一行的数据结构,结果可能会存在数据缺失。
3)非单行指令,如需要设定变量等操作,都需要添加return使用脚本查询;
4)]}、{[等特殊字符的组合antlr第三方工具包无法正常解析,需要通过在中括号和大括号之间加了换行规避处理;
如直接执行db.test.find({"name":{$in:["ttt"]}}),会报错:
添加换行后即正常:
db.test.find(
{"name":{
$in:["ttt"]
}}).toArray()
5)如果MongoDB开通了auth认证鉴权,使用return关键字执行脚本查询,MongoDB业务库配置的用户需要开通执行eval指令的权限,如有anyAction或anyResource的权限,如果没有执行eval指令的权限会提示报错,如下图所示
开通权限命令:
db.createRole({role:"executeFunctions",privileges:[{resource:
{anyResource:true},
actions:["anyAction"]}],roles:[]})
db.grantRolesToUser("yourusername", [
{ role: "executeFunctions", db: "admin" }
])