嵌入仪表板

2025-06-30

本文介绍如何在外部网站或应用程序中嵌入 AI/BI 仪表板。工作区管理员必须先定义潜在的嵌入图面，然后才能嵌入仪表板。有关配置工作区管理仪表板嵌入的详细信息。

至少具有“可编辑”权限的用户可以从“共享”对话框生成仪表板的 iframe 代码。已发布仪表板的所有共享设置仍然有效。只有已被显式授予访问权限的用户才能查看嵌入式仪表板。请参阅共享仪表板，了解有关共享仪表板的详细信息。嵌入式仪表板遵循与所有其他仪表板相同的缓存和刷新节奏。请参阅缓存和数据刷新。

生成嵌入代码

若要嵌入仪表板，请使用以下步骤：

打开要嵌入的已发布仪表板。请参阅查看和组织仪表板，了解如何在工作区中查看和访问仪表板。
单击右上角的“共享”。
单击“共享”对话框中的“嵌入仪表板”。
此时会打开“复制嵌入代码”对话框。如果存在允许的嵌入域列表，则列出域。单击“复制”按钮复制代码片段。
将嵌入代码插入到任何支持 HTML 嵌入并能呈现 iframe 内容的平台或应用程序中。请参阅示例。

注意

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

示例

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

在 Confluence 中嵌入

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

编辑嵌入代码以仅包含生成的 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>
```
将 iframe 元素插入页面。若要了解如何在页面中插入 iframe，请参阅 Confluence 的文档。
将已编辑的嵌入 URL 粘贴到 URL 文本字段中，并将宽度设置为 100%。
根据偏好调整其他设置。

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

嵌入 Salesforce 知识

若要在 Salesforce Knowledge 页中嵌入仪表板，请完成以下步骤：

创建 Visualforce 页面。有关说明，请参阅 Salesforce 文档。
在“页面编辑”屏幕中，将光标移动到 Visualforce 标记编辑器中。
将您复制的嵌入代码粘贴到两个 <apex:page></apex:page> 标签之间。
在嵌入代码周围添加两个段落标记 (<p></p>)。

以下示例使用占位符 <dashboard-embed-code> 来演示 Visualforce 标记的外观。实例应包含所复制的完整嵌入代码。
```
<apex:page >
<p><dashboard-embed-code></p>
</apex:page>
```
以保存更改。
单击“预览”并确认仪表板呈现效果。
复制组件预览的 URL 并创建新的 iframe 组件。它应类似于以下代码片段。占位符 <your-salesforce-domain> 应替换为 Salesforce 域。
```
<iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>
```
转到要嵌入仪表板的 Knowledge 页。
单击“ 编辑 > 添加媒体组件”。
将上一步中的 iframe 代码粘贴到“嵌入”文本字段中。

在 SharePoint 中嵌入

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

转到要在其中托管嵌入式仪表板的 SharePoint 页面。
将“嵌入”元素添加到页面。
将完整的嵌入代码粘贴到屏幕右侧的网站地址或嵌入代码字段中。
在其他地方单击以确认。

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

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

复制唯一标识符

单个小组件的标识符是页面 name 值和小组件 name 值的组合，由 tilda （~）分隔。

注意

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

如要复制唯一标识符，请执行以下操作：

在 Azure Databricks 工作区中打开已发布的仪表板。
单击要嵌入的小组件的串形菜单。
单击查看全屏或复制链接到小部件。 URL 包含相关的页面和小组件 name 值。
复制搜索参数 fullscreenWidget 和等号后的所有内容（=）。

以下示例显示全屏小组件 URL 的最后一部分：
```
fullscreenWidget=53eadf26~3490f286
```

调整生成的嵌入代码

请参阅生成嵌入代码，查找生成仪表板嵌入代码的步骤。
将 &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 来确保干净状态：

注销所有活动的 Azure Databricks 会话。
单击 URL 旁边的滑块图标。
单击 Cookie 和网站数据 ，禁用或阻止 第三方 Cookie。系统会提示你刷新页面。
刷新页面，然后单击嵌入 iframe 中的 “登录 ”。应显示一条错误消息。关闭浏览器窗口。
在 Cookie 和站点数据下，允许 第三方 Cookie。
再次刷新页面。
转到嵌入式仪表板并单击“ 登录”。

通过