MongoDB BI Connector 详细介绍与使用指南（手动安装方式，CentOS 7 + MongoDB 5.0.5）
目录
一、BI Connector 工作原理
二、手动下载与安装 BI Connector（适配 MongoDB 5.0.5，Linux x86_64）
1. 进入 MongoDB 官方下载中心
2. 解压并安装
3. 启动 BI Connector
三、认证与远程连接
1. 启用用户名和密码
2. 允许远程访问
四、BI 工具连接示例
五、注意事项
六、总结
在数据可视化和分析场景中，企业常常希望把 MongoDB 数据接入 Tableau、Power BI、Grafana 等 BI 工具。但这些工具通常只支持 SQL，而 MongoDB 使用 BSON 与聚合语法。
MongoDB BI Connector (BIC) 就是解决方案：它提供 SQL ↔ MongoDB 的转换，让 BI 工具通过 MySQL 协议 查询 MongoDB 数据。
一、BI Connector 工作原理
-
BI 工具（如 Grafana、Power BI）使用 MySQL 驱动连接 BI Connector。
-
BI Connector 把 SQL 翻译为 MongoDB 聚合管道。
-
MongoDB 返回数据，BI Connector 再转换成 SQL 结果返回给 BI 工具。
二、手动下载与安装 BI Connector（适配 MongoDB 5.0.5，Linux x86_64）
1. 进入 MongoDB 官方下载中心
打开浏览器访问：
👉 MongoDB Download Center (BI Connector)
选择参数：
-
Version: 5.0
-
OS: Linux x86_64 (RHEL 7 / CentOS 7)
-
Package: tar.gz
会下载一个类似：
mongodb-bi-linux-x86_64-rhel70-v2.14.6.tgz
的压缩包（具体版本可能更新）。
2. 解压并安装
下载到服务器后执行：
tar -zxvf mongodb-bi-linux-x86_64-rhel70-v2.14.24.tgz
cd mongodb-bi-linux-x86_64-rhel70-v2.14.24
解压后你会看到 bin/ 目录，其中有：
mongosqld mongotranslate
建议把 bin 加入到环境变量：
echo 'export PATH=$PATH:/data/mongodb-bi-linux-x86_64-rhel70-v2.14.24/bin' >> ~/.bashrc source ~/.bashrc
3. 启动 BI Connector
mongosqld \ --mongo-uri="mongodb://localhost:27017" \ --addr=0.0.0.0:3307 \ --logPath /var/log/mongosqld.log
参数说明：
-
--mongo-uri：MongoDB 地址（你的是 v5.0.5，默认本地 27017）。 -
--addr：监听的地址和端口（默认 3307，模拟 MySQL 协议）。 -
--logPath：日志路径。
三、认证与远程连接
1. 启用用户名和密码
如果 MongoDB 开启了认证：
mongosqld \ --mongo-uri="mongodb://myUser:myPassword@localhost:27017/mydb?authSource=admin" \ --addr=0.0.0.0:3307
-
myUser：MongoDB 用户名 -
myPassword：密码 -
authSource=admin：认证库
2. 允许远程访问
--addr=0.0.0.0:3307
开放防火墙端口：
sudo firewall-cmd --zone=public --add-port=3307/tcp --permanent sudo firewall-cmd --reload
如果是云服务器，还需在安全组放行 3307。
四、BI 工具连接示例
在 Grafana / Tableau / Power BI 中，配置数据源：
-
主机：
<mongosqld服务器IP> -
端口：
3307 -
用户名：MongoDB 用户名
-
密码：MongoDB 密码
-
数据库：目标数据库名（如
mydb）
这样，BI 工具就能通过 MySQL 协议直接访问 MongoDB 数据了。
五、注意事项
-
你的 MongoDB 5.0.5 是社区版 → 必须手动下载 Enterprise BI Connector。
-
版本要匹配 → MongoDB 5.0.x 对应 BI Connector 2.14.x。
-
性能优化 → 经常查询的字段要建索引，否则 SQL 转换会慢。
-
安全性 → 强烈建议配置用户密码，不要直接暴露 3307。
六、总结
-
你使用的是 CentOS 7 + MongoDB 5.0.5 (社区版)。
-
需要去 MongoDB 官网 手动下载 BI Connector tar.gz 包。
-
解压后运行
mongosqld即可提供 MySQL 接口。 -
配置用户名、密码、远程访问后，即可在 Grafana / Power BI / Tableau 等 BI 工具中使用 MySQL 驱动直连 MongoDB。