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

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

创建计划

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

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

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

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

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

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

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

若要创建计划，请执行以下操作：

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

   

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

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

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

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

   • 使用默认值： 应用仪表板筛选器小组件中的默认值。
   • 使用筛选器选择： 应用创建计划时设置的筛选器值。

6. 使用 SQL 仓库 下拉菜单为计划运行选择不同的 SQL 仓库。

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

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

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

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

管理时间表

编辑、暂停或删除计划：

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

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

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

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

管理订阅

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

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

订阅目的地

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

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

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

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

若要订阅其他用户，请执行以下作：

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

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

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

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

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

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

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

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

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

• 未定义任何角色。

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

取消订阅电子邮件更新

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

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

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

  

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

订阅的仪表板大小限制

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

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

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

PDF 附件的数据安全性

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

PDF 删除策略

计划更新（电子邮件订阅）： 电子邮件过程完成后，会立即从对象存储中删除 PDF。

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