在Azure Databricks Excel插件中安排自动数据刷新

Important

此功能目前以公共预览版提供。

注释

Azure Databricks Excel外接程序在Azure 政府或Azure中国区域不可用。

计划刷新会按计划自动运行导入,从而使导入到 Excel 工作簿中的数据保持最新。 你可以为保存的查询、表或数据透视表导入创建计划,选择每次刷新运行的SQL仓库,并查看Azure Databricks Excel插件的最近运行记录。

要了解定时刷新如何连接Microsoft 365以及适用哪些网络安全功能,请参见Azure Databricks Excel插件架构与安全性。

Prerequisites

在创建定时刷新之前,请确保:

定时刷新使用创建计划者的 Azure Databricks 身份和 Microsoft 凭证执行。 保持这些凭证有效,这样 Azure Databricks 可以查询数据并更新工作簿。

Microsoft 权限

你的 Excel 加载项文件必须在 AppDomains 部分中包含以下域。 如果你在计划刷新发布之前就安装了 Excel 加载项,请把该域添加到加载项文件中,或者重新下载该文件。 请参阅 设置 Azure Databricks Excel 加载项。

<AppDomain>https://login.microsoftonline.com</AppDomain>

该加载项会请求以下 Microsoft 权限;你必须同意这些权限,计划刷新才能访问并更新工作簿:

  • Files.ReadWrite:读取并更新你的工作簿。
  • offline_access:即使你未主动登录,也让计划刷新继续运行。

创建计划

为来自 Azure Databricks Excel 加载项的任何已保存查询、表或数据透视表导入创建计划刷新。

  1. 打开 Azure Databricks Excel 加载项。
  2. 转到已保存的导入。
  3. 找到你想要自动刷新的导入。
  4. 选择该导入旁边的日历按钮。
  5. 查看资产详细信息,以确认你选择了正确的查询、表或数据透视表。
  6. 在管理计划选项卡上,输入一个描述性的计划名称。
  7. 选择一种计划类型。 请参阅间隔和计划:
    • 间隔:按指定的分钟数、小时数、天数或周数进行刷新。
    • 计划:选择基于日历的节奏和时间,例如每天的特定时间或每周的特定一天。
  8. 如果你选择了计划,请确认时区。 初始时区基于你的本地浏览器设置。
  9. 在 SQL Warehouse中,选择运行查询的仓库。
  10. 选择创建计划。

创建计划后,已保存导入项的日历按钮会变为日历加时钟图标。

一项显示“日历带时钟”图标的已保存导入,该图标表示已计划刷新,并显示其导入位置和上次刷新时间。

时间间隔

当刷新应按固定周期重复时,请使用间隔。 输入一个数字,并选择分钟、小时、天或周。

可用的间隔范围如下:

  • 1 至 120 分钟
  • 1 到 72 小时
  • 1 到 31 天
  • 1 到 8 周

如果刷新必须在特定星期几的特定时间运行,请使用 Schedule,而不要使用每周间隔。

“管理计划”选项卡,已选择“间隔”计划类型,显示“每隔”字段、SQL 仓库选择器和“创建计划”按钮。

日程

当刷新必须在特定日历时间运行时,请使用计划。 根据节奏,你可以选择:

  • 频率,例如按分钟、小时、天、周或月
  • 一天中的具体时间
  • 每周计划的工作日
  • 每月计划的日期
  • 时区

时间会根据选定的排班时区进行评估。 运行历史记录时间戳会使用查看者的区域设置显示。

“管理计划”选项卡,已选择“计划”计划类型,显示频率、时间和时区选择器。

更新现有的日程表

更改你已创建的计划的名称、频率、时区或 SQL 仓库。

  1. 在已保存的导入中,选择该导入对应的“日历带时钟”按钮。
  2. 在管理计划选项卡上,更改计划名称、节奏、时区或 SQL 仓库。
  3. 选择更新计划。

更新底层已保存的导入还会使其查询、参数、筛选器和行数限制与计划刷新保持同步。 下一次运行使用更新后的导入定义。

回顾运行历史

查看某个计划导入的近期刷新运行结果,包括每次运行的状态、持续时间以及任何失败详细信息。

  1. 打开已保存导入的计划。
  2. 选择运行历史选项卡。
  3. 查看最近的运行。 每个条目显示其完成时间、状态和持续时间。
  4. 展开某次运行以查看更多详细信息,包括刷新失败时的错误消息。

运行状态包括:

  • 正常:刷新已成功完成。
  • 正在运行:刷新仍在进行中。
  • 失败:刷新未完成。 展开该运行以查看可用的故障详情。

如果计划尚未运行,该选项卡会显示暂无运行历史记录。

删除定时导入

计划刷新不提供暂停日程或仅删除日程的单独选项。

要从 Excel 加载项中停止该计划,请删除已保存的导入:

  1. 在已保存的导入中,打开该导入的操作菜单。
  2. 选择 删除。

删除已保存的导入也会删除其关联的定时刷新作业,并将保存的导入配置从工作簿中移除。

Troubleshooting

如果计划刷新未运行或工作簿未更新,请使用以下部分来识别并解决最常见的原因。

您的Microsoft凭证已过期

定时刷新需要通过你的 Microsoft 帐户来访问该工作簿。 如果插件显示以下消息,则表示您的凭证已过期:

你的Microsoft凭证已过期。 登录以使计划刷新继续运行。

选择Microsoft 登录,并完成登录流程。 即使凭证已过期,计划仍可能显示为已配置,但在恢复访问权限之前,刷新操作无法更新工作簿。

计划刷新失败

如果某次运行显示失败状态,请依次执行以下检查以确定原因:

  1. 打开计划,选择运行历史记录。
  2. 展开失败运行并查看其错误信息。
  3. 确认你的Microsoft 帐户仍然连接着。
  4. 确认该工作簿仍存在于 OneDrive 或 SharePoint 中,并且你的帐户可以编辑它。
  5. 确认所选的 SQL 仓库可用,并且你可以运行源查询。
  6. 确认你仍有权访问源表及其他引用的数据。
  7. 如果导入时使用Excel单元格引用作为参数或过滤器,请确认所引用的工作表和单元格仍然存在。

工作簿未在更新

如果运行显示成功,但工作簿中的数据已过时,请确认工作簿仍位于预期位置且可访问:

  1. 从OneDrive或SharePoint位置打开该工作簿。
  2. 确认自上次更新计划以来,工作簿没有被移动、重命名或替换。
  3. 如果出现提示,请重新连接你的 Microsoft 帐户。
  4. 查看 运行历史 以获取最新状态和错误详情。