다음을 통해 공유

管理计划仪表板更新和订阅

计划仪表板更新可确保仪表板显示 up-to日期信息,并提高最终用户的性能。 订阅通过向电子邮件发送仪表板快照来通知利益干系人。 本页介绍如何设置和管理这两种功能。

创建计划

创建仪表板更新计划时,可以设置一个周期性节奏,以拉取最新数据;对于使用共享数据权限发布的仪表板,还会刷新共享缓存。

对于每个计划的仪表板更新,将发生以下情况:

  • 定义数据集的所有 SQL 逻辑都以指定的时间间隔运行。
  • 结果会填充查询结果缓存,并帮助改进初始仪表板加载时间。

共享数据权限在计划更新中的优势

与单个数据权限相比,使用 共享数据权限 发布的仪表板可提供更好的性能和缓存效率:

  • 共享缓存: 计划更新会填充所有仪表板查看者可以访问的共享查询结果缓存,从而显著提高所有用户的加载时间。
  • 单个缓存刷新: 即使仪表板已发布具有单个数据权限,用户也可以订阅计划以触发缓存刷新。 这可确保其个人缓存保持最新,并减少他们访问仪表板时的加载时间。
  • 减少了查询负载: 由于结果是缓存和共享的,因此基础 SQL 查询的运行频率较低,从而减少计算成本和仓库负载。

订阅计划的用户受益于这些缓存刷新,即使他们不需要电子邮件 PDF 快照。 订阅会启动缓存刷新工作流,确保用户在访问仪表盘时快速加载。

若要创建计划,请执行以下操作:

  1. 单击仪表板右上角的“计划”。 此时会显示“添加计划”对话框。

    “添加计划”对话框

  2. 输入新计划的名称标识符。

  3. 如有必要,请使用下拉选择器指定频率和开始时间。 (可选)选择“显示 cron 语法”复选框以在“Quartz Cron 语法”中编辑时间表。

  4. 使用 时区 下拉菜单选择时区。

  5. 选择 “使用默认值 ”或 “使用筛选器选择 ”来确定在计划运行期间仪表板中应用了哪些筛选器值。

    • 使用默认值: 应用仪表板筛选器小组件中的默认值。
    • 使用筛选器选择: 应用创建计划时设置的筛选器值。
  6. 使用 SQL 仓库 下拉菜单为计划运行选择不同的 SQL 仓库。

    默认情况下,用于创建和运行仪表板的 SQL 仓库也会用于计划运行。 使用此设置来选择要运行计划更新的其他仓库。

  7. (可选)单击 “订阅者” 以添加订阅者。 订阅者在计划运行完成后收到包含仪表板 PDF 快照的电子邮件。

  8. 单击 “创建” 。 将显示“计划”对话框,并显示所创建的计划。 如果此仪表板存在其他计划,对话框还会显示这些计划。

如果已为此仪表板创建计划,右上角的按钮会显示“订阅”。 使用前面所述的工作流来安排时间表。

注意

对于具有定义开始时刻的时间表,刷新频率每天从该时刻开始。 例如,一个计划设置为每隔 4 小时运行一次,从 15:10 开始运行,分别在 15:10、19:10、23:10 等进行,持续到第二天的 15:09。 然后节奏重置,并在15:10再次开始。

管理时间表

编辑、暂停或删除计划:

  1. 在已发布的仪表板上单击调度。 将显示仪表板的时间表列表。

  2. 单击您要管理的计划右侧的烤肉串菜单 Kebab 菜单图标。

  3. 单击“ 编辑”、“ 暂停”或 “删除”。

    • 编辑: 打开计划 UI。 使用 UI 调整计划,然后保存。
    • 暂停恢复: 设置计划是活动还是已暂停。 暂停的计划会保留其配置和订阅者设置,但在恢复计划之前,仪表板不会更新或发送通知。
    • 删除: 删除计划和所有订阅者设置。

管理订阅

计划订阅者在计划每次执行时会收到当前仪表板的快照。 订阅者通过电子邮件或 Slack 接收仪表板快照。 电子邮件订阅者会收到 PDF 快照。 Slack 通道接收直接在通道中可见的 PNG 图像快照、用于在 Azure Databricks 中打开仪表板的直接链接,以及消息线程中的 PDF 附件。 对于包含多个页面的仪表板,快照显示仪表板的第一页。

对于使用共享数据权限发布的仪表板,订阅计划也会触发缓存刷新,从而提高仪表板加载时间。 即使用户不需要电子邮件通知,用户也可以订阅,从而在访问仪表板时获得更快的性能。

重要

订阅列表最多可以包含 100 个订阅者。 无论发送的消息数如何,通知目标都算作一个订阅者。

订阅目的地

仪表板订阅支持以下目标:

  • 电子邮件:工作区用户和电子邮件通知目标通过电子邮件接收 PDF 快照。 可以将帐户用户、通讯组列表和外部用户(如合作伙伴或客户端)配置为电子邮件通知目标。

注意

如果无法添加电子邮件订阅者,则工作区管理员可能已关闭工作区的电子邮件通知。 请参阅 AI/BI 管理指南

工作区管理员必须先定义通知目标,然后才能将其选为订阅者。 请参阅 管理通知目的地 以了解电子邮件目的地。

如果仪表板上至少具有 CAN EDIT 权限,则可以添加和删除其他订阅者以接收更新。 如果您在仪表板上至少具有 CAN VIEW 权限,则可以将自己添加或移除为现有计划的订阅者。

若要订阅其他用户,请执行以下作:

  1. 单击仪表板右上角的“订阅”。 随即将出现“计划”对话框。
  2. 确定要将订阅者添加到的计划。 请单击该日程右侧的Kebab 菜单图标。 然后单击“编辑”。

如果对具有已分配计划的仪表板具有 CAN VIEW 访问权限,则可以在每次计划运行时订阅自己接收更新。

若要为自己订阅现有计划,请执行以下操作:

  1. 单击仪表板右上角的“订阅”按钮。 “计划”对话框显示仪表板的所有计划。
  2. 单击所选计划右侧的“订阅”

如果无法将自己添加为订阅者,则可能是以下原因导致:

  • 工作区管理员已关闭为工作区“启用仪表板订阅”选项。

    此设置优先于所有其他设置。 如果工作区管理员已关闭此设置,仪表板编辑器仍可以分配计划,但无法分配订阅者。

  • 你必须有权访问该工作区。

    帐户用户只能作为通知目标添加为订阅者。 帐户用户的仪表板上没有“订阅”按钮。

  • 未定义任何角色。

    对于没有定义计划的仪表板,具有 CAN VIEW 或 CAN RUN 访问权限的工作区用户无法与 “订阅 ”按钮交互。

取消订阅电子邮件更新

订阅者可以选择通过取消订阅计划来停止接收通知。

  • 若要使用仪表板 UI 取消订阅,请执行以下作:

    1. 单击仪表板右上角的“订阅”按钮。 “计划”对话框显示仪表板的所有计划。
    2. 单击“已订阅”以取消订阅。 按钮文本会更改为“订阅”

    从“已订阅”到“订阅”的 UI 更改。

  • 使用电子邮件页脚中的“取消订阅”链接取消订阅计划更新。

注意

当用户(包含在为电子邮件通知设置的较大通讯组列表中)选择使用电子邮件页脚中的链接取消订阅时,该操作将取消订阅整个通讯组列表。 整个组会从订阅中移除,而不会收到将来的 PDF 快照更新。

订阅的仪表板大小限制

仪表板订阅电子邮件包括以下 base64 编码文件:

  • PDF:包含完整仪表板的 PDF 文件。
  • DesktopImage:针对在台式计算机上查看进行优化的图像文件。

有关超出限制的仪表板订阅大小限制和行为的信息,请参阅 仪表板订阅限制

PDF 附件的数据安全性

为计划交付或下载生成仪表板 PDF 时,会在创建工作区期间临时存储在工作区管理员配置的云存储中。 此存储由 Azure Databricks 管理,不能直接在外部访问。 了解 PDF 所在的位置及其删除方式有助于解决安全性和合规性要求。 请参阅 使用 Azure 门户部署工作区

PDF 删除策略

计划更新(电子邮件订阅): 电子邮件过程完成后,会立即从对象存储中删除 PDF。

用户启动的下载: 当用户从 UI 手动下载仪表板 PDF 时,文件暂时保留在对象存储中长达 60 天。 此保留期允许有时间在需要时进行下载完成、故障排除或重新下载。