如何将Windows端PowerBI Desktop连接至本地挂载的Spark Delta Lake表

前置要求 #

• 已完成Delta Lake PowerBI 连接器安装
• Samba挂载路径在Windows下可正常读取，且路径指向Delta表的根目录（即包含_delta_log文件夹的目录）

数据源添加步骤 #

• 打开PowerBI Desktop，点击顶部菜单栏「获取数据」→「更多」
• 在数据源搜索框输入 Delta Lake，选中对应连接器后点击「连接」
• 在弹出的配置窗口中，「根文件夹路径」填写Samba挂载到Windows的完整路径，示例：Z:\data\delta_sales_table
• 按需选择「导入」或「DirectQuery」连接模式，点击「确定」完成数据源基础配置

查询语句编写 #

进入Power Query编辑器后，直接调用DeltaLake.Table函数即可读取本地Delta表，无需额外适配存储类型：

let
    // 括号内第一个参数替换为你的Delta表挂载路径即可
    源 = DeltaLake.Table("Z:\data\delta_sales_table", [])
in
    源

如果需要做分区筛选、列裁剪等操作，直接在查询链中追加对应处理步骤即可，连接器会自动读取Delta事务日志优化查询效率，无需手动解析parquet文件。

异常排查 #

• 路径权限报错：检查Samba共享的读权限配置，确保Windows当前用户对挂载目录及_delta_log子目录有读取权限
• 识别不到Delta表：确认填写的路径为Delta表根目录，不要指向分区子目录或单独的parquet文件
• 数据版本不一致：确保查询过程中Linux集群侧没有对该Delta表执行写入操作，避免Samba同步延迟导致的数据偏差

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