基本仪表板嵌入

本页演示如何在外部应用程序中将仪表板嵌入为 iframe。 查看者使用其 Databricks 帐户或工作区凭据访问仪表板。

生成嵌入代码

若要生成可粘贴到外部应用程序中的嵌入代码,请执行以下作:

  1. 打开要嵌入的已发布仪表板。 请参阅 “查看和组织仪表板 ”,了解如何在工作区中查看和访问仪表板。

  2. 单击右上角的“ 共享 ”。

  3. “共享”对话框中单击“嵌入”仪表板

  4. 此时会打开 “复制嵌入代码 ”对话框。 如果存在允许的嵌入域的列表,则列出域。 单击 “复制”图标 ,复制按钮以复制代码片段。

    “复制嵌入代码”对话框显示可以嵌入已发布仪表板的生成的 iframe 代码和域。

  5. 将嵌入代码插入支持 HTML 嵌入的任何平台或应用程序中,并可以呈现 iframe 内容。 请参阅 示例

注释

如果 “复制嵌入代码 ”对话框包含不包含目标域的允许域列表,则工作区管理员可以添加它。 请参阅 “管理仪表板”和“Genie”访问权限

例子

以下示例包括有关在应用程序中嵌入仪表板的分步指南。 每组说明都假定你已经复制了上一部分中概述的嵌入代码。

在 Confluence 中嵌入

生成的嵌入代码需要稍有调整才能满足 Confluence 的要求。 若要在 Confluence 页中嵌入仪表板,请完成以下步骤:

  1. 编辑嵌入代码以仅包含生成的 URL,而不是 iframe 标记或其他标记值。

    在编辑之前,嵌入代码包括 iframe HTML 标记、指向仪表板的链接以使用 iframe 中的源,以及高度、宽度和边框的其他规范,如以下代码片段所示。 对于仪表板,示例占位符 <databricks-instance-name> 包含 <dashboard-and-workspace-ID> 与工作区和仪表板关联的实际值。 如下所示:

    • 登录工作区时,这是 <databricks-instance-name> URL 的第一部分。 请参阅获取工作区对象的标识符
    • 这是 <dashboard-and-workspace-ID> 指向仪表板的 URL 的最后一部分。 它看起来类似于: a4bf23c498752e79f1a2d6b4c9087e31?o=3498561237865447
    <iframe src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>" width="100%" height="600" frameborder="0"></iframe>
    

    编辑字符串,使其仅包含链接文本,如以下示例所示。

    https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>
    
  2. 将 iframe 元素插入页面。 若要了解如何在页面中插入 iframe,请参阅 Confluence 的文档

  3. 将编辑的嵌入 URL 粘贴到 URL 文本字段中,并将宽度设置为 100%。

  4. 根据偏好调整其他设置。

嵌入在“Confluence”页面草稿中的仪表板。

嵌入 Salesforce 知识

若要在 Salesforce 知识页中嵌入仪表板,请完成以下步骤:

  1. 创建 Visualforce 页面。 有关说明,请参阅 Salesforce 的文档

  2. “页面编辑” 屏幕中,将光标移动到 Visualforce 标记 编辑器中。

  3. 粘贴在两 <apex:page></apex:page> 个标记之间复制的嵌入代码。

  4. 在嵌入代码周围添加两个段落标记(<p></p>)。

    以下示例使用占位符 <dashboard-embed-code> 来演示 Visualforce 标记的外观。 实例应包含复制的完整嵌入代码。

    <apex:page >
    <p><dashboard-embed-code></p>
    </apex:page>
    
  5. 单击“ 保存” 保存所做的更改。

  6. 单击 “预览 ”并确认仪表板呈现。

  7. 复制组件预览的 URL 并创建新的 iframe 组件。 它应类似于以下代码片段。 占位符 <your-salesforce-domain> 应替换为 Salesforce 域。

    <iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>
    
  8. 转到要嵌入仪表板的“知识”页。

  9. 单击“ 编辑 > 添加媒体组件”。

  10. 将上一步中的 iframe 代码粘贴到 “嵌入 文本”字段中。

在 SharePoint 中嵌入

若要在 SharePoint 中嵌入仪表板,可能需要将 Azure Databricks URL 添加到 SharePoint 上嵌入内容的允许网站列表。 请参阅 [Azure 文档] 了解如何允许在 SharePoint 页面上嵌入内容。 然后,完成以下步骤:

  1. 转到要在其中托管嵌入式仪表板的 SharePoint 页面。

  2. Embed 元素添加到页面。

  3. 将完整的嵌入代码粘贴到 网站地址中,或在屏幕右侧嵌入代码 字段。

  4. 单击以确认。

嵌入在草稿 SharePoint 页面中的仪表板

嵌入单个小组件

若要从仪表板嵌入单个小组件,需要仪表板嵌入代码和要显示的小组件的唯一标识符。

复制唯一标识符

单个小组件的标识符是页面 name 值和小组件 name 值的组合,由 tilda (~) 分隔。

注释

密钥 name 显示在定义仪表板的序列化文件中,并且无法从 Azure Databricks UI 访问。 它与 displayName 值分开,该值定义 UI 中显示的页面名称。 请参阅 “编辑仪表板”文件

复制唯一标识符:

  1. 在 Azure Databricks 工作区中打开已发布的仪表板。

  2. 单击 Kebab 菜单图标。 要嵌入的小组件的 kebab 菜单。

  3. 单击“ 查看全屏 ”或 “复制”链接到小组件。 URL 包含相关的页面和小组件 name 值。

  4. 复制搜索参数 fullscreenWidget 和等号后的所有内容(=)。

    以下示例显示了全屏小组件的 URL 的最后一部分:

    fullscreenWidget=53eadf26~3490f286
    

调整生成的嵌入代码

  1. 请参阅 “生成嵌入代码 ”,查找生成仪表板嵌入代码的步骤。

  2. 添加到 &fullscreenWidget=<ID> 嵌入 URL,替换为 <ID> 组合 <page-name>~<widget-name> 值。

例如,如果基本嵌入 URL 如下所示:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=<ID>"

具有唯一标识符的已更新嵌入 URL 应如下所示:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=53eadf26~82f66691"

查看嵌入式仪表板

嵌入式仪表板为查看者提供了一种安全的方式来访问 Azure Databricks 外部的仪表板数据。 所有现有共享设置都适用。 必须向预期查看者授予对仪表板的访问权限。 请参阅谁可以访问仪表板? 访问嵌入式仪表板时,系统会提示查看者登录到 Azure Databricks,除非他们具有从最近登录到同一工作区的活动会话。

若要查看嵌入式仪表板,请执行以下作:

  • 导航到仪表板已嵌入的页面。
  • 如有必要,请使用 Azure Databricks 凭据登录。

嵌入仪表板中的登录屏幕示例

注释

如果尚未授予仪表板访问权限的已注册用户尝试查看仪表板,他们会收到一条错误,指出仪表板不可用。 请参阅 “共享已发布的仪表板 ”,了解如何调整共享设置。

刷新嵌入式仪表板

嵌入式仪表板的所有查看者都可以按需手动刷新仪表板。 还可以设置计划来定期刷新仪表板。

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

嵌入式仪表板疑难解答

本部分列出了可能会遇到的常见问题,并提供建议的解决方法:

嵌入的 iframe 为空

如果嵌入的 iframe 未显示数据,可能是因为你禁用了第三方 Cookie。 启用第三方 Cookie 是允许外部内容(如嵌入式仪表板)在另一个网页中正常运行所必需的。

你可以调整浏览器设置,以允许或取消阻止第三方 Cookie 来解决此问题。 如果不想允许所有第三方 Cookie,许多浏览器允许为允许第三方 Cookie 的特定站点添加例外。 有关管理 Cookie 的详细说明,请参阅浏览器的帮助文档。

以下步骤说明如何在 Chrome 浏览器中重启启用了第三方 Cookie 的会话。 此过程通过首先禁用,然后重新启用第三方 Cookie 来确保干净状态:

  1. 注销所有活动的 Azure Databricks 会话。

  2. 单击 URL 旁边的滑块图标。

  3. 单击 Cookie 和网站数据 ,禁用或阻止 第三方 Cookie。 系统会提示你刷新页面。

  4. 刷新页面,然后单击嵌入 iframe 中的 “登录 ”。 应显示一条错误消息。 关闭浏览器窗口。

  5. Cookie 和站点数据下,允许 第三方 Cookie

  6. 再次刷新页面。

  7. 转到嵌入式仪表板并单击“ 登录”。

后续步骤