清除缓存(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。它仍然请求旧列,服务器拒绝了请求。
2. Microsoft Excel 清理协议
Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»当我们直接通过 Power Query 从 Excel 消费分析 API 时,必须清除两个不同的缓存以强制更新模式:
- 在功能区中,转到数据选项卡。
- 单击获取数据 -> 数据源设置(Data Source Settings)
- 在全局或当前工作簿的数据源列表中查找我们的 Business Central API 路径。
- 单击清除权限(Clear Permissions)
- 打开 Power Query 编辑器(双击右侧窗格中的查询)
- 转到文件 -> 选项和设置 -> 查询选项
- 在左侧面板中,在「GLOBAL」部分下选择数据加载
- 单击清除缓存按钮(Clear Cache)
- 最后,在 Power Query 编辑器中,单击刷新预览。系统将重新进行身份验证并正确读取新列。
3. Power BI Desktop 清理协议
Sección titulada «3. Protocolo de Limpieza en Power BI Desktop»Power BI 中的行为与 Excel 相同,但选项分布略有不同。
- 转到文件 -> 选项和设置 -> 选项
- 在左侧菜单中,「GLOBAL」下选择数据加载(Data Load)
- 在「数据缓存选项」部分中,单击清除缓存
- (可选)如果我们使用 Q&A,也会点击“清除 Q&A 缓存”。
- 关闭选项窗口
- 在主视图(或 Power Query 中)单击刷新。由于没有本地缓存,Power BI 将进行干净的 HTTP 调用以下载我们 API 的新 JSON 模式,立即解决错误。
- ✓ 权限调试:在重新组织或更改 Entra ID 的 UPN 后清除损坏的全局凭据。
- ✓ 架构更新:清除 Power Query 中的本地数据缓存,以重新加载来自 ERP 的文档
$metadata。 - ✓ 最终验证: 验证 Power Query 视图中的导入列以确保它们与 AL 的当前定义相匹配。

