MongoDB BI Connector 详细介绍与使用指南（手动安装方式，CentOS 7 + MongoDB 5.0.5）

[一、BI Connector 工作原理](#一、BI Connector 工作原理)

[二、手动下载与安装 BI Connector（适配 MongoDB 5.0.5，Linux x86_64）](#二、手动下载与安装 BI Connector（适配 MongoDB 5.0.5，Linux x86_64）)

[1. 进入 MongoDB 官方下载中心](#1. 进入 MongoDB 官方下载中心)

[2. 解压并安装](#2. 解压并安装)

[3. 启动 BI Connector](#3. 启动 BI Connector)

三、认证与远程连接

[1. 启用用户名和密码](#1. 启用用户名和密码)

[2. 允许远程访问](#2. 允许远程访问)

[四、BI 工具连接示例](#四、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。