Fabric：SQL端点无法显示快捷方式表问题排查求助

查看错误信息的核心渠道 #

• Lakehouse作业历史记录
  进入ws1的Lakehouse，点击左侧「管理」>「作业历史记录」，筛选与快捷方式创建/同步相关的作业，查看执行日志中的失败提示或警告信息。也可以在创建快捷方式操作后，点击右上角通知中的「查看详情」直接跳转至对应日志。

• SQL端点元数据刷新日志
  打开ws1的SQL端点，进入「管理」选项卡，找到「元数据刷新」或「日志」入口，查看同步Lakehouse快捷方式元数据时的具体错误，比如元数据解析失败、权限验证错误等。

• Lakehouse快捷方式管理页
  在ws1的Lakehouse中切换到「快捷方式」标签，找到指向ws2新表的快捷方式，查看其状态（如「已连接」/「异常」），点击快捷方式卡片的「详情」或「查看日志」，获取创建及同步过程中的报错详情。

• Fabric监控中心
  在Fabric门户左侧导航栏点击「监控」，筛选ws1工作区，查看Lakehouse和SQL端点的告警、事件日志，这里会汇总工作区内所有资源的异常记录，包括快捷方式同步失败的相关信息。

• 系统视图SQL查询验证
  在ws1的SQL端点执行以下查询，直接从系统元数据层面排查：

  -- 查看是否存在目标表的元数据记录
  SELECT * FROM sys.tables WHERE name = '你的快捷方式表名';
  SELECT * FROM sys.external_tables WHERE name = '你的快捷方式表名';
  
  -- 查看最近的元数据加载请求状态
  SELECT * FROM sys.dm_exec_requests WHERE command LIKE '%metadata%';
  

补充排查方向 #

• 权限校验：确认ws1的SQL端点服务主体拥有访问ws2 Lakehouse对应存储路径的权限（快捷方式本质是外部存储链接，权限不足会导致元数据无法同步）。
• 表格式检查：验证ws2中Notebook创建的新表是否为Delta Lake格式（Fabric SQL端点仅识别Delta格式的Lakehouse快捷方式表）。
• 手动刷新元数据：在ws1的SQL端点界面点击「刷新元数据」按钮，强制触发元数据同步，排除界面缓存导致的显示问题。

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