PowerBI Desktop连接DocumentDB遇System Error 126的解决与替代方案

一、修复ODBC驱动系统错误126的步骤 #

系统错误126本质是驱动DLL无法找到依赖组件，可按以下顺序排查：

• 检查位数匹配：确认PowerBI的位数（帮助>关于）与安装的DocumentDB ODBC驱动位数一致。若PowerBI是32位，需卸载当前64位驱动，重新安装对应32位版本。
• 补全VC++运行库依赖：DocumentDB ODBC驱动依赖微软VC++ Redistributable包，安装对应位数的最新版VC++运行库后重启电脑。
• 手动注册驱动DLL：以管理员身份打开命令提示符，执行以下命令注册DLL：

  regsvr32 "C:\Program Files\Amazon DocumentDB\ODBC Driver\documentdb.odbc.dll"
  

  若提示注册成功，再尝试在PowerBI中连接。
• 验证文件权限：确保PowerBI进程拥有C:\Program Files\Amazon DocumentDB\ODBC Driver\目录的读写权限，右键文件夹>属性>安全>添加当前用户并授予相应权限。

二、无需ODBC的替代连接方案 #

如果ODBC驱动问题无法解决，可通过以下方式连接DocumentDB与PowerBI：

1. MongoDB BI连接器（兼容DocumentDB） #

DocumentDB兼容MongoDB协议，使用MongoDB官方BI连接器：

• 安装MongoDB BI连接器后，配置它连接到DocumentDB集群。
• 在PowerBI中选择「MongoDB」数据源，通过BI连接器的端口连接，或使用连接器生成的ODBC数据源。

2. Python脚本直接读取（PowerBI内置支持） #

利用PowerBI的Python脚本功能，通过pymongo库直接连接DocumentDB：

• 先在本地安装pymongo和dnspython包（用pip install pymongo dnspython）。
• 在PowerBI中点击「获取数据>其他>Python脚本」，输入以下代码（替换为你的集群信息）：

  import pymongo
  import pandas as pd
  
  # 替换为你的DocumentDB连接字符串
  client = pymongo.MongoClient(
      "mongodb://<用户名>:<密码>@<集群端点>:27017/?ssl=true&ssl_ca_certs=rds-combined-ca-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false"
  )
  db = client["你的数据库名"]
  collection = db["你的集合名"]
  
  # 将集合数据转为DataFrame供PowerBI使用
  df = pd.DataFrame(list(collection.find()))
  

• 运行脚本后即可加载数据到PowerBI模型。

3. 导出到S3再连接 #

通过AWS Lambda定期将DocumentDB数据导出为CSV/Parquet格式存储到S3，然后PowerBI直接连接S3数据源读取文件。

内容的提问来源于stack exchange，提问作者Adrian