BI Connector 连不上 MongoDB 7.0 主因是认证机制不匹配（SCRAM-SHA-1 已禁用）及 TLS 配置不当；聚合变慢因 $lookup 等未下推；实时性受限于缓存与轮询；点号字段需手动 $project 重命名。
BI Connector 连不上 MongoDB 7.0？先确认认证机制和 TLS 版本
Atlas BI Connector 默认使用 SCRAM-SHA-256 认证，而部分旧版 BI 工具（如 Tableau Desktop 2022.4 之前）默认只支持 SCRAM-SHA-1。MongoDB 7.0 已禁用 SCRAM-SHA-1，直接导致连接失败并报错 Authentication failed。
解决方法：
- 升级 BI 工具到支持
SCRAM-SHA-256的版本（Tableau ≥ 2022.4，Power BI ≥ 2023 Q2） - 在 Atlas 集群的「Database Access」中，确保用户权限包含
readAnyDatabase或对应数据库的read角色 - BI Connector 启动时必须显式启用 TLS：配置项
--ssl不够，要加--sslAllowInvalidCertificates（仅测试环境）或正确挂载 CA 证书路径到--sslCAFile - 连接字符串里不能省略
authMechanism=SCRAM-SHA-256，例如：mongodb://user:pwd@bi-connector-host:27017/?authSource=admin&authMechanism=SCRAM-SHA-256
为什么聚合管道在 BI 工具里变慢？BI Connector 不自动下推 $lookup 和 $facet
BI Connector 本质是 SQL-to-Aggregation 翻译层，但它对复杂阶段的支持有限。$lookup（尤其带 pipeline 的）、$facet、$graphLookup 等不会下推到 MongoDB 执行，而是由 BI Connector 进程本地拉取原始数据后内存计算——这会导致全量集合扫描、高内存占用和超时。
实操建议：
- 避免在视图或报表中直接拖拽跨集合字段；改用预聚合视图：在 MongoDB 中创建
db.createView()，把 $lookup + $project 提前固化，BI Connector 只需查视图 - 确认 BI Connector 日志是否出现
WARNING: Could not push down stage: $lookup—— 这是性能瓶颈的明确信号 - 对高频分析字段，提前建好复合索引，尤其是
{ status: 1, createdAt: -1 }这类过滤+排序组合 - 不要依赖 BI 工具的“自动 JOIN”，它大概率触发嵌套循环拉取；手动在 Atlas 中建好带
$lookup的视图更可控
如何让 Power BI / Tableau 实时反映数据变化？注意 BI Connector 的缓存行为
BI Connector 默认开启元数据缓存（--metadataCacheTTL，默认 300 秒），且对集合 schema 变更不敏感。如果 MongoDB 中新增字段或修改类型，BI 工具可能仍显示旧结构，甚至报 Column 'xxx' not found。
关键配置项：
- 启动时加
--metadataCacheTTL=0关闭元数据缓存（生产环境慎用，会增加每次查询的 schema 发现开销） - 若使用 Power BI 的 DirectQuery 模式，确保 BI Connector 运行参数含
--enableDirectQuery=true，否则降级为 Import 模式 - Tableau 中需手动刷新「Data Source」→「Refresh Now」，不是刷新工作表；且首次连接后要点击「Show Details」确认实际执行的是
find还是aggregate - BI Connector 不支持 change stream 推送，所谓“实时”仍是轮询，最小轮询间隔由 BI 工具自身控制（如 Power BI Gateway 默认 15 分钟）
聚合结果字段名含点号（.）导致 BI 工具解析失败？必须重命名
MongoDB 允许字段名含 . 和 $，但 SQL 标准不支持。BI Connector 遇到 {"user.profile.name": "Alice"} 这类嵌套路径展开后的字段，会生成非法列名，Tableau 报 Invalid column name，Power BI 直接跳过该字段。
唯一可靠解法是在聚合管道中显式 $project 重命名：
db.orders.aggregate([
{ $lookup: { from: "users", localField: "userId", foreignField: "_id", as: "user" } },
{ $unwind: "$user" },
{ $project: {
orderId: "$_id",
userName: "$user.profile.name",
total: "$amount"
}}
])
切记：不能依赖 BI Connector 的自动扁平化（如 user.profile.name → user_profile_name），它只在极简场景生效，且不可配。
BI Connector 在 MongoDB 7.0 上不是“即插即用”的代理层，它的 SQL 兼容性边界、缓存策略和字段映射规则都必须手动对齐。最容易被忽略的是：你看到的“SQL 查询”背后，可能是一次全集合扫描 + 内存 join，而不是数据库原生执行。
