Ir al contenido

清除缓存(Excel & Power BI)

在 Business Central 部署新 API 后解决元数据和缓存模式冲突的操作协议。

0阅读

在我们持续集成/持续交付(CI/CD)的日常操作中,我们经常修改 AL 语言的 API,以添加新列或重命名现有列(例如,从 numDocumento 改为 Num_Documento)。

尽管在 Business Central 的部署成功,但 Microsoft 客户端工具(Excel 和 Power BI Desktop)使用极其激进的元数据缓存系统以节省带宽。这会导致它们尝试根据旧的模式“快照”读取 API,从而导致数据摄入完全崩溃。

此冲突的明确症状是 Power Query 中的以下错误:

Detalles: "OData: The property 'numDocumento' does not exist on type 'Microsoft.NAV.comercialAlbaranCompra'. Make sure to only use property names that are defined by the type or mark the type as open type."

DevSecOps 诊断:源数据库已更改,但本地客户端(Excel/Power BI)拒绝下载新的 OData 文档 $metadata。它仍然请求旧列,服务器拒绝了请求。

当我们直接通过 Power Query 从 Excel 消费分析 API 时,必须清除两个不同的缓存以强制更新模式:

  1. 在功能区中,转到数据选项卡。
  2. 单击获取数据 -> 数据源设置(Data Source Settings)
  3. 在全局或当前工作簿的数据源列表中查找我们的 Business Central API 路径。
  4. 单击清除权限(Clear Permissions)
  1. 打开 Power Query 编辑器(双击右侧窗格中的查询)
  2. 转到文件 -> 选项和设置 -> 查询选项
  3. 在左侧面板中,在「GLOBAL」部分下选择数据加载
  4. 单击清除缓存按钮(Clear Cache)
  5. 最后,在 Power Query 编辑器中,单击刷新预览。系统将重新进行身份验证并正确读取新列。

Power BI 中的行为与 Excel 相同,但选项分布略有不同。

  1. 转到文件 -> 选项和设置 -> 选项
  2. 在左侧菜单中,「GLOBAL」下选择数据加载(Data Load)
  3. 在「数据缓存选项」部分中,单击清除缓存
  4. (可选)如果我们使用 Q&A,也会点击“清除 Q&A 缓存”。
  5. 关闭选项窗口
  6. 在主视图(或 Power Query 中)单击刷新。由于没有本地缓存,Power BI 将进行干净的 HTTP 调用以下载我们 API 的新 JSON 模式,立即解决错误。
  • ✓ 权限调试:在重新组织或更改 Entra ID 的 UPN 后清除损坏的全局凭据。
  • ✓ 架构更新:清除 Power Query 中的本地数据缓存,以重新加载来自 ERP 的文档 $metadata。
  • ✓ 最终验证: 验证 Power Query 视图中的导入列以确保它们与 AL 的当前定义相匹配。