如何快速集成MongoDB至Quick BI？

概述

Quick BI支持直接连接MongoDB数据库，实现数据的高效分析与可视化展示。本文档将指导您如何通过公网或阿里云VPC连接MongoDB至Quick BI，并详细介绍连接过程中的注意事项及限制条件。

准备工作

网络连接确认

• 公网连接:
  • 将 Quick BI的IP地址添加至MongoDB数据库的白名单中。
  • 参考文档: 添加安全组规则
• 内网连接:
  • 若MongoDB部署于阿里云ECS上，可通过阿里云VPC连接。
  • 或者搭建跳板机并通过SSH隧道访问数据库。

账号准备

• 获取自建MongoDB数据库的用户名和密码。

使用限制

• 仅限空间管理员和组织管理员角色的新建数据源权限。
• 支持MongoDB 5.7.12版本。

步骤一: 安装MongoDB BI连接器

1. 下载连接器:

   • 访问MongoDB Connector for BI，选择与本地操作系统相匹配的版本。

   

2. 解压缩文件:

   • 解压下载的文件。

   

3. 启动Mongosqld服务:

   • 配置命令行参数启动服务:

     ./mongosqld --mongo-uri <Mongo_address> --auth -u <Username> -p <Password>  --schemaRefreshIntervalSecs <Schema_refresh> --addr <Binding_address>

   • 参数说明:
     • Mongo_address: MongoDB连接地址。
     • Username: root权限用户名。
     • Password: root权限密码。
     • Schema_refresh: 同步MongoDB中Database、collections信息到内存中的间隔时间（建议值: 86400秒）。
     • Binding_address: 绑定端口，如0.0.0.0:3307。
   • 示例:
     • 普通实例:

       ./mongosqld --mongo-uri mongodb://xxxx1.mongodb.rds.aliyuncs.com:3717  --addr 0.0.0.0:3307 -u root -p xxxx --auth --schemaRefreshIntervalSecs 86400

     • 副本集实例:

       ./mongosqld --mongo-uri mongodb://xxxx1.mongodb.rds.aliyuncs.com:3717,xxxx2.mongodb.rds.aliyuncs.com:3717/?replicaSet=mgset-xxxx  --addr 0.0.0.0:3307 -u root -p xxxx --auth --schemaRefreshIntervalSecs 86400

   出现 ./mongodrdl: error while loading shared libraries: libssl.so.1.1: cannot open shared object file: No such file or directory，说明没有安装成功libssl，需要如下操作：

   # 从官网下载
   wget https://www.openssl.org/source/openssl-1.1.1e.tar.gz
   # 编译安装
   tar -xvf openssl-1.1.1e.tar.gz
   cd openssl-1.1.1e
   ./config shared --openssldir=/usr/local/openssl --prefix=/usr/local/openssl
   make && make install
   # 配置
   echo "/usr/local/lib64/" >> /etc/ld.so.conf
   ldconfig
   # 验证
   openssl version

步骤二: 添加自建数据源MongoDB

1. 登录Quick BI控制台:

   • 访问Quick BI控制台。

2. 添加数据源:

   • 从创建数据源入口进入创建数据源界面。
   • 选择“显示更多”选项。
   • 选择MongoDB数据源。

   

3. 配置连接:

   • 显示名称: 输入规范的名称，避免使用特殊字符。
   • 数据库地址: MongoDB BI连接器服务的地址。
   • 端口: 数据库端口号。
   • 数据库: 自定义的数据库名称。
   • 用户名和密码: 具备数据库操作权限的账户信息。
   • VPC数据源 (可选):
     • 适用于MongoDB部署在阿里云ECS上的情况。
     • 需要配置AccessKey ID（获取AccessKey）、AccessKey Secret（获取AccessKey）、ECS实例ID及区域（查看实例信息 ）等信息。
   • SSH (可选):
     • 适用于通过SSH隧道访问的情况。
     • 需要提供跳板机的IP地址、用户名、密码及端口等信息。
     • 参见 通过密码认证登录Linux实例

4. 连接测试:

   • 单击“连接测试”按钮验证连接是否成功。

   

5. 完成添加:

   • 测试成功后点击“确定”，完成数据源添加。

后续步骤

• 创建数据集: 将MongoDB数据库中的数据表或自定义QL添加至Quick BI，参见 创建并管理数据集 。
• 数据分析与展示: 创建仪表板并添加可视化图表进行数据分析，参见参见 新建仪表板 和 可视化图表概述 。
• 深入分析: 利用钻取功能进行更深层次的数据探索，参见 钻取设置与展示。

通过以上步骤，您可以轻松地将MongoDB数据库中的数据接入Quick BI，实现高效的数据分析与可视化展示。