仪表盘介绍

什么是仪表盘？

仪表盘将一组问题分组到单个页面上的选项卡中。您可以将仪表盘视为可共享的报表，其中包含一组相关问题。您可以设置通过电子邮件或 Slack 订阅仪表盘，以接收仪表盘问题的导出结果。

一个仪表盘包含一组排列在网格上的卡片。这些卡片可以是

• 问题。您可以从集合中添加问题，或将已保存的问题直接添加到仪表盘。
• 文本和标题卡片
• Iframe 卡片
• 链接卡片

您可以向仪表盘添加筛选器小部件，以在多个问题中完全相同地筛选数据，并自定义当人们单击图表或表格时发生的情况。

您可以根据需要制作任意数量的仪表盘。尽情发挥吧。

如何创建仪表盘

在屏幕的右上角，单击+ 新建 > 仪表盘。为您的新仪表盘命名并添加描述，选择仪表盘应放入哪个集合，然后单击创建，Metabase 将带您进入全新的仪表盘。

向仪表盘添加或保存问题

您可以添加已保存到集合的问题，或将问题直接保存到仪表盘。

从仪表盘

编辑仪表盘时，您可以通过单击右上角的 + 图标来添加问题。您可以从新问题、SQL/原生查询或现有问题添加图表。

您无法添加已保存到其他仪表盘的问题。如果您想将问题添加到多个仪表盘，您应该将该问题保存到一个集合中。或者，如果这些问题不需要保持同步，您可以复制一个问题，并将副本保存到您的仪表盘。请记住，对一个问题的更改不会影响重复的问题。

从问题

在创建或编辑问题时，您可以将问题直接保存到仪表盘。该问题只能由该仪表盘使用。

添加已保存到集合的问题

要将已保存到集合的问题添加到仪表盘，请访问该问题，然后单击右上角的三个点菜单 (…) 并选择添加到仪表盘。您也可以从仪表盘编辑模式浏览问题。

将问题添加到仪表盘不会将问题保存到仪表盘。

如果问题保存在您的个人集合中，您将只能将该问题添加到您的个人集合中的仪表盘。如果您想将问题添加到公共集合中的仪表盘，您需要将您的问题移出您的个人集合。

使用文本卡片添加标题或描述

您可以做的另一件很棒的事情是将标题和文本卡片添加到您的仪表盘。文本卡片允许您在仪表盘中包含描述、解释、注释，甚至图像和 GIF。您还可以使用文本卡片在仪表盘中的图表部分之间创建分隔，或者包含指向其他仪表盘、问题或网站的链接。

要添加新的文本卡片，请创建一个新的仪表盘（或编辑现有的仪表盘），然后单击右上角的文本卡片按钮 T

您有两个选项

• 标题：预格式化的标题文本卡片，跨越仪表盘的宽度。
• 文本：可自定义的文本卡片，将呈现 Markdown 格式的文本。

每个文本卡片都有两种模式：编写和预览。当您单击以聚焦卡片时，卡片将进入编辑模式。当您单击离开卡片时，Metabase 将呈现卡片以向您展示它在实时仪表盘上的外观。

您可以使用 Markdown 格式化文本卡片中的文本，创建内联表格或代码片段，甚至嵌入链接的图像（对 GIF 友好点，朋友们）。要预览呈现的卡片，只需单击离开卡片即可。

要了解更多信息，请参阅在仪表盘中使用 Markdown 的乐趣。

在文本卡片中包含变量

您可以在文本卡片中包含一个变量，然后将该变量连接到仪表盘筛选器。您需要做的就是将单词包裹在双大括号中，{{ 和 }}（变量不能包含任何空格）。例如，您可以添加一个带有以下文本的文本卡片

# {{state}} orders

并将该变量连接到筛选状态的仪表盘筛选器小部件。如果有人在状态筛选器中选择了 WI，则 markdown 卡片中的文本将显示：WI 订单。

您还可以通过将文本包裹在双中括号中使文本成为可选，[[ 和 ]]

# Orders [[from {{state}}]

在这种情况下，短语 from {{state}} 仅在有人在筛选器小部件中选择了一个值（或多个值）时才会显示。

要查看如何将筛选器连接到卡片，请参阅仪表盘筛选器。

链接卡片

链接卡片是专门的卡片，可让您搜索和链接到 Metabase 中的其他项目。您也可以将它们用于外部链接。用于将人们指向与您的仪表盘相关的其他资源非常有用。

要向仪表盘添加链接卡片，请单击铅笔图标进入仪表盘编辑模式，然后单击链接图标。单击链接卡片中的输入字段，以在您的 Metabase 中搜索要链接到的项目，或粘贴外部链接。

链接卡片支持变量，因此您可以使用仪表盘筛选器来更新链接卡片 URL 中的值。例如，您可以使用双大括号在 URL 中包含变量，如下所示

https://www.example.com/{{path}}

要为变量提供值，您需要向仪表盘添加筛选器，并将该筛选器连接到卡片的变量（在本例中为 path）。参数仅支持非 Metabase URL（即，您手动输入的 URL，而不是您从 Metabase 搜索和选择的 URL）。您可以选择性地为变量设置默认值。请参阅将筛选器或参数小部件连接到仪表盘卡片。

Iframe 卡片

Iframe 允许您在一个 HTML 页面中嵌套另一个 HTML 页面。借助 Metabase 中的 iframe 卡片，您可以在仪表盘中嵌入网页。您可以嵌入

• 用于数据输入或工作流程的电子表格或调查
• 用于在仪表盘上情境化和讲故事的视频或幻灯片
• 来自其他工具的实时图表和可视化

要向仪表盘添加 iframe 卡片，请单击铅笔图标进入仪表盘编辑模式，然后单击链接图标并选择 Iframe。然后粘贴 iframe URL。以下是我们关于如何创建仪表盘的视频的 iframe

<iframe
  width="560"
  height="315"
  src="https://www.youtube.com/embed/W-i9E5_Wjmw?si=qWeMGxEymVOIHiXo"
  title="YouTube video player"
  frameborder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
  referrerpolicy="strict-origin-when-cross-origin"
  allowfullscreen
></iframe>

瞧，一个带有嵌入式视频的仪表盘

Iframe 卡片支持变量，以便您可以使用筛选器小部件来更新 iframe 中的值。例如，您可以使用双大括号在 iframe 的 src URL 中包含变量，如下所示

src="https://www.youtube.com/embed/{{video_id}}

要为变量提供值，您需要向仪表盘添加筛选器，并将该筛选器连接到卡片的变量（在本例中为 video_id）。您可以选择性地为变量设置默认值。请参阅将筛选器或参数小部件连接到仪表盘卡片。

仪表盘选项卡

您可以向仪表盘添加多个选项卡，以保持卡片的有序性。

复制选项卡

在仪表盘编辑模式下，您可以通过单击要复制的选项卡旁边的向下箭头来复制选项卡及其所有卡片。

在选项卡之间移动卡片

请参阅排列卡片。

复制仪表盘

如果您不想从头开始构建仪表盘，或者想通过更改现有仪表盘而不影响原始仪表盘来进行实验，您可以复制现有仪表盘。

要复制仪表盘，请单击仪表盘右上角的 … 菜单，然后选择复制。

默认情况下，Metabase 将创建一个新仪表盘，其中包含原始仪表盘中问题的副本（包括仪表盘的选项卡）。Metabase 会将重复的问题保存到目标集合或重复的仪表盘，具体取决于原始问题的保存位置。

复制仅包括仪表盘、其卡片布局、筛选器和（可选）问题。未复制的内容：仪表盘订阅，或任何共享或嵌入数据设置。例如，如果您复制了一个已公开的仪表盘，则默认情况下，复制的仪表盘不会公开。

排列仪表盘卡片

要编辑仪表盘卡片并移动它们，请单击仪表盘右上角的铅笔图标以进入仪表盘的编辑界面。

编辑卡片

进入编辑模式后，您将看到一个网格出现。您可以根据自己的喜好移动和调整仪表盘中卡片的大小，它们会吸附到网格上。

• 复制卡片：将鼠标悬停在卡片上，然后单击“复制”图标。
• 将卡片移动到新选项卡：将鼠标悬停在卡片上，单击“移动”图标，然后选择要将卡片移动到的选项卡。
• 在选项卡内移动卡片：单击并拖动卡片。其他卡片将移开。
• 调整卡片大小：单击卡片右下角的控点，然后拖动以调整大小。附近的卡片将移开以适应新的大小。
• 删除卡片：将鼠标悬停在卡片上，然后单击右上角的 X 图标。
• 替换卡片：将鼠标悬停在卡片上，然后单击右上角的“替换”图标。搜索要替换卡片上现有问题的其他问题。您只能用另一个问题替换问题，而不能用其他类型的卡片（如文本卡片）替换。

Metabase 将自动更新问题的显示，以确保您的数据在您选择的任何大小下看起来都很棒。

仪表盘部分

为了加快卡片排列速度，您可以向仪表盘添加部分。

部分是带有标题和预先排列的卡片的模板。将部分添加到仪表盘后，您可以为每个卡片选择问题，并进行任何其他更改。您只能为卡片选择问题，而不能选择其他类型的卡片（如文本卡片）。

如果您忘记为卡片设置问题，仪表盘将只呈现一个空白卡片。

部分包括

KPI 网格

带有右侧 KPI 的大型图表

带有下方大型图表的 KPI

仪表盘宽度

您可以通过转到右上角的三个点菜单来更改仪表盘的宽度

• 固定宽度（默认）。Metabase 会将布局限制为屏幕中心处的固定宽度。此固定宽度可以保持仪表盘布局在较小的笔记本电脑屏幕和较大的桌面屏幕之间保持一致。
• 全宽。布局和卡片将展开以占据屏幕的整个宽度。

更改卡片的可视化设置

您可以更改卡片的可视化设置（例如，添加目标线）。更改卡片的可视化设置只会影响问题在该仪表盘卡片上的显示方式；这些更改不会影响原始问题的可视化设置。

单击铅笔图标进入仪表盘编辑模式，将鼠标悬停在要编辑的问题上，然后单击调色板图标以编辑卡片的可视化设置。

当卡片未返回结果时隐藏卡片

一个值得一提的巧妙之处：如果您有一个很少返回结果的问题卡片，但您仍然希望在仪表盘中包含该卡片，因为您想知道问题何时返回结果，您可以告诉 Metabase 隐藏卡片，除非它至少返回一行数据。

在仪表盘编辑模式下，单击卡片的可视化设置。

• 如果卡片显示表格，则该选项位于列选项卡中。
• 如果卡片显示图表，则该选项位于显示选项卡中。

切换选项在没有结果时隐藏此卡片。当您打开此选项时，查询仍将在后台运行，但仪表盘不会显示该卡片。如果查询返回结果，仪表盘将显示该卡片，并根据您在仪表盘编辑模式下排列卡片的方式移动其他卡片以为其腾出空间。

重置卡片的可视化设置

如果您想将仪表盘卡片恢复为其原始可视化设置（即，首次保存到仪表盘时问题的设置）

1. 转到您的仪表盘，然后单击铅笔图标进入编辑模式。
2. 将鼠标悬停在您要编辑的卡片（问题）上。
3. 单击调色板图标以调出该卡片的可视化设置。
4. 单击重置为默认值。
5. 单击完成以保存卡片的可视化设置。
6. 单击保存以保存仪表盘。

全屏仪表盘

在您创建了理想的仪表盘之后，您可能希望将仪表盘放在电视上，以便让您的团队在一天中随时了解最新情况。

要进入全屏模式，请单击仪表盘右上角的全屏图标（带有箭头指向相反方向的图标）。进入全屏模式后，您还可以将仪表盘切换到“夜间模式”以获得更高的对比度。

自动刷新

如果您的数据频繁更新，您可以设置仪表盘自动刷新，只需单击时钟图标即可。

您可以将仪表盘设置为以 1、5、10、15、30 和 60 分钟的间隔更新，具体取决于您需要数据有多新鲜。

启用自动刷新将按照您选择的间隔重新运行仪表盘上的所有查询，因此在设置自动刷新时，请记住仪表盘的大小和问题的复杂性。

将全屏模式和自动刷新结合使用是让您的团队在一天中与您的数据保持同步的好方法。

缓存仪表盘结果

请参阅每个仪表盘的缓存。

通过公共链接共享仪表盘

如果您的 Metabase 管理员启用了对已保存问题或仪表盘的公开共享，您可以转到该问题或仪表盘并单击共享图标以查找其公共链接。

任何人都可以查看公共链接，即使他们没有 Metabase 的访问权限。您还可以使用公共嵌入代码将您的问题或仪表盘嵌入到简单的网页或博客文章中。请查看我们在 embedding-reference-apps 存储库中包含嵌入式仪表盘的简单应用程序示例。要了解有关嵌入的更多信息，请查看我们关于如何使用 Metabase 向您的客户交付分析的文章，以及关于如何结合品牌推广、单点登录、完整应用程序嵌入和数据沙箱来交付多租户、自助服务分析的文章。

从仪表盘导出结果

请参阅导出结果。

通过 URL 配置仪表盘

您可以修改仪表盘的 URL 以自动进入全屏、启用夜间模式或自动刷新仪表盘。自定义仪表盘的 URL 允许您配置仪表盘 - 即使您无法访问将要显示仪表盘的设备，例如脚本屏幕。

要使用 URL 配置仪表盘，您可以添加以下可选关键字

• fullscreen
• night
• refresh

这是一个 URL 示例

https://metabase.mydomain.com/dash/2#refresh=60&fullscreen&night

其中 refresh=60 部分将仪表盘设置为每 60 秒自动刷新，fullscreen 将其设置为全屏模式，night 将其设置为夜间模式（夜间模式仅在使用全屏时有效）。在关键字之间使用 & 符号 &，并确保在仪表盘的 ID 号之后有一个井号 #。

fullscreen 选项有一个重要的限制：出于安全原因，许多浏览器需要用户交互才能启动全屏。在这些浏览器中，使用 fullscreen 选项将启用 Metabase 中的全屏 UI，但不会扩展浏览器内容以填充屏幕。为了确保仪表盘占据整个屏幕，请通过单击 UI 中的按钮激活全屏，或使用 fullscreen URL 选项并在全屏或 kiosk 模式下启动浏览器。

仪表盘版本历史

对于问题、仪表盘和模型，Metabase 会保留该项目前 15 个版本的版本历史记录。

请参阅历史记录。

验证仪表盘

请参阅内容验证。

删除仪表盘

请参阅删除和恢复。

创建有用的仪表盘的技巧

要创建一个出色的仪表盘，您首先需要确定您希望仪表盘讲述关于您数据的什么内容。哪些问题将让您深入了解您想知道的内容？考虑仪表盘的主题或主题会有所帮助 — 类似于“客户满意度”或“第二季度销售目标”。

一些技巧

• 强调最重要的的问题。为了吸引人们对最重要事项的关注，请将最重要的已保存问题卡片放在仪表盘的顶部附近，和/或使它们比其他卡片更大。
• 保持仪表盘的重点突出。如果您的仪表盘上有超过 10 张卡片，请考虑将仪表盘分成两个单独的仪表盘。您不希望用太多信息让人感到不知所措，并且每个仪表盘都应该围绕一个主题或主题。请记住 - 您可以创建任意数量的仪表盘，因此您不必将所有内容都塞进一个仪表盘中。
• 向仪表盘添加筛选器。向仪表盘添加筛选器使其更有用。例如，与其让您的仪表盘充满仅限于特定时间跨度的问题，不如创建更通用的问题并使用仪表盘筛选器来更改您正在查看的时间跨度。
• 使您的仪表盘具有交互性。 自定义当用户单击仪表盘中的图表或表格时发生的情况。

延伸阅读

• 仪表盘筛选器
• 交互式仪表盘
• 具有多条系列的仪表盘图表
• 仪表盘订阅
• 使仪表盘更快