KPI（单值）图表

注意： **KPI 可视化** 功能目前处于预览版阶段，受服务专用条款的“通用服务条款”部分中的“非正式版产品条款”的约束。非正式版产品和功能“按原样”提供，可能只能获得有限的支持。如需了解详情，请参阅发布阶段说明。

我们鼓励您分享反馈，帮助我们改进。如需报告 bug 或问题，请发送电子邮件至 [e-mail]，并提供以下详细信息：

• 对问题和预期行为的清晰描述
• 重现问题的步骤
• 任何其他相关详细信息

启用 KPI 可视化 预览版功能 后，您可以使用 Looker 中的 KPI（单值） 图表选项直观呈现 KPI 数据点。在探索中，KPI（单值） 图表选项会替换 单值 图表选项。

KPI 可视化 预览版功能为用户提供以下功能：

• 添加辅助可视化图表：用户可以在可视化图表中添加迷你图或条形图，以显示与主要 KPI 相关的趋势或分布情况。
• 显示增强的比较：用户可以使用第一行、第二行、最后一行或总计行中的数据，在探索查询中指定主要值并将其与任何其他度量进行比较。
• 访问改进的样式选项：用户可以更好地控制可视化图表的外观，包括功能块的背景颜色和值的对齐方式。

重要提示 ：KPI 可视化 预览版功能默认处于停用状态。

本页面提供了有关为 Looker（原始版本）或 Looker (Google Cloud Core) 实例启用和使用 KPI 可视化 预览版功能的指南。本页面包括以下部分：

• 用户和实例要求
• 启用 KPI 可视化
• 须知事项
• KPI（单值）图表选项
• 相关资源

用户和实例要求

如需启用和使用 KPI 可视化 预览版功能，必须满足以下要求：

• 您的 Looker（原始版本）或 Looker (Google Cloud Core) 实例必须运行 Looker 26.10 或更高版本，并且您的 Looker（原始版本）实例必须由 Looker 托管。
• 您必须拥有 管理员 Looker 角色 才能启用 KPI 可视化 预览版功能。
• 如需查看探索并与之互动（包括创建可视化图表），您必须拥有以下权限：
  • 用户 Looker 角色或其他包含 explore 权限
  • 访问探索所基于的底层 LookML 模型，以便在可视化图表中查看和使用其字段

启用 KPI 可视化

KPI 可视化预览版功能默认处于启用状态。

管理员可以按照以下步骤启用或停用 KPI 可视化 预览版功能：

1. 在 Looker 中，点击管理员选项在主导航菜单中。
2. 点击常规 部分下的预览 选项，打开预览版功能 页面。
3. 点击 KPI 可视化 开关，以启用或停用预览版功能。

须知事项

当信息中心上显示多个单值可视化图表时，每个可视化图表默认使用相同的字体大小，以保持外观一致。不过，当功能块大小减小时，单值可视化图表会自动调整字体大小。如果可视化图表的字体无法在可用空间中显示完整的值，则该值会被省略号 (...) 截断。

如果启用了 Smart Single Value Text Size 功能，信息中心功能块中单值可视化图表上显示的字体会自动调整大小，以便在任何给定大小的功能块中至少显示 8-10 个值字符。

KPI（单值）图表选项

重要提示：

• 启用 KPI 可视化 预览版功能后，单值 图表选项会被 KPI（单值）图表 选项替换。
• 如果菜单中列出的选项与您选择的其他设置冲突，则这些选项可能会显示为不可用或被隐藏。

如需修改 KPI（单值）图表，请在探索的可视化图表 窗格中点击tune 修改 。

进入修改模式后，用户可以在样式、比较和格式设置菜单中进行选择，以自定义 KPI（单值）可视化图表的外观。

“样式”菜单选项

样式 菜单包含以下选项。

颜色集合

从颜色集合 菜单中选择一个颜色集合。借助集合，您可以创建主题可视化图表和信息中心，让它们看起来协调一致。您可以在 颜色集合 文档页面上查看 Looker 的每个内置颜色集合中的所有调色板。您的 Looker 管理员还可以为您的组织创建自定义颜色集合。

值颜色

如需设置图表值的颜色，请点击值颜色 部分中的色样，打开颜色选择器菜单。

• 如需从调色板中选择颜色，请点击颜色选择器菜单的调色板 标签页，然后使用向左和向右箭头滚动浏览可用的调色板。点击调色板中的颜色即可选择颜色。
• 如需选择自定义颜色，请点击调色板选择器的自定义 标签页，然后使用颜色渐变和值滑块选择自定义颜色，或者在输入字段中输入 RGB 十六进制字符串（例如 #2ca6cd）或 CSS 颜色名称（例如 mediumblue）。

Looker 将对带有和不带超链接的单值可视化图表使用所选颜色。

您可以根据需要考虑使用以下替代方法：

• 更改字体颜色以区分结果的好坏：在比较菜单中开启显示比较值设置，然后选择显示为变化选项。
• 更改特定字段值的字体颜色（包括在探索的数据窗格中）：LookML 开发者可以向字段定义添加html参数。

自动调整值的大小

启用自动调整值的大小 选项会自动调整信息中心功能块中显示的单值可视化图表的字体大小。字体大小会调整为在功能块中至少显示 8-10 个值字符；如果可视化图表中的字符在给定大小下水平或垂直溢出，字体大小将逐渐减小。允许的最小字体大小为 14 像素。达到最小字体大小后，任何溢出的字符都会被省略号 (...) 截断。允许的最大字体大小为 104 像素。

使用此功能时，信息中心上的单值功能块看起来可能不太一致，但较小的功能块可以容纳更多字符。

如果Smart Single Value Text Size 设置在管理员 > 常规设置 页面上启用，则此设置无效。如需使用此可视化图表级控件，必须停用管理员级设置。

显示标题

您可以确定是否在数字下方显示标题。对于已保存的 Look，默认标题是 Look 的名称。您还可以使用标题 字段指定其他标题。

标题替换

您可以指定要与值一起显示的标题。当显示标题 处于开启状态时，此字段可用。对于已保存的 Look，如果此字段留空，标题将默认为已保存的 Look 的名称。

显示迷你图

开启显示迷你图 设置，以显示辅助可视化图表，该图表会显示数据值的变化。开启此设置后，您可以使用以下设置自定义辅助可视化图表：

• 图表类型：选择面积图或柱形图作为辅助可视化图表。
• 图表颜色：为辅助可视化图表选择颜色，类似于“值颜色”设置。
• 显示 X 轴：开启此设置可显示辅助图表的 X 轴值。

主值

您可以使用此部分中的设置选择 KPI（单值）可视化图表的主值，包括：

• 主要系列：从探索中选择一个度量，将其设置为主要系列。当比较 菜单中的显示比较值 设置处于开启状态时，该度量的值将作为比较对象。
• 主要行：指定要显示的主要系列中的行值。选项包括 1st、2nd、Last 和 Total （当 总计 处于启用状态时）。默认情况下，系统会选择 1st 。
• 对齐方式：为可视化图表中的值选择对齐方式选项。选项包括左对齐、居中对齐和右对齐。此设置适用于可视化图表中的所有值。

“比较”菜单选项

比较 菜单包含以下选项。

显示比较值

您可以开启显示比较值 设置，将第二个字段中的比较信息添加到 KPI（单值）可视化图表中。启用显示比较值 设置后，您可以使用比较 菜单中显示的样式选项。

比较系列

比较系列显示在可视化图表中的主要系列下方。您可以使用此部分中的设置选择用于比较的辅助值，包括：

• 比较系列：从探索中选择一个度量，将其设置为比较系列。所选度量的值将作为与主要值进行比较的对象。
• 比较行：指定要显示的比较系列中的行值。选项包括 1st、2nd、Last 和 Total （当 总计 处于启用状态时）。默认情况下，系统会选择 1st 。
• 值标签：您可以指定如何在可视化图表中使用比较系列。选项包括：
  • 显示为值：显示比较系列的值。
  • 显示为变化：显示比较值，并使用条件格式来指示与主要系列相比的变化类型。如果值的变化为负值，则三角形指向下方。如果值的变化为正值，则三角形指向上方。默认情况下，负数以红色显示，并带有红色三角形；正数以绿色显示，并带有绿色三角形。您可以通过开启正值为负 设置来切换这些颜色。
  • 显示为百分比变化：显示比较系列的值，以及与主要系列相比的百分比变化，并使用条件格式来指示变化类型。如果值的百分比变化为负值，则三角形指向下方。如果值的百分比变化为正值，则三角形指向上方。默认情况下，负百分比以红色显示，并带有红色三角形；正百分比以绿色显示，并带有绿色三角形。您可以通过开启正值为负 设置来切换这些颜色。
  • 计算增减：主要字段的值除以比较字段的值，百分比以进度条的形式显示。
  • 计算增减（以百分比显示）：主要字段的值除以比较字段的值。百分比以进度条的形式显示，并带有百分比和比较字段值的标签，例如“83% of $347.8 K”。如果显示标签 设置处于开启状态，则进度条还会显示比较字段的标签，例如“83% of $347.8 K Monthly target”。
• 显示标签：开启此设置可显示比较字段的标签。默认情况下，标签是比较字段的名称。如果您想显示其他标签，请在标签 字段中输入新标签。

“格式设置”菜单选项

开启启用条件格式 ，以通过指定感兴趣的值来定义规则，从而对可视化图表进行颜色编码。

颜色集合

借助集合，您可以创建主题可视化图表和信息中心，让它们看起来协调一致。所有 Looker 内置的颜色集合都会显示在颜色集合文档页面上。您的 Looker 管理员还可以为您的组织创建自定义颜色集合。

您可以从颜色集合 菜单中选择一个颜色集合。每个规则中色样的调色板都来自该集合。

包括 Null 值（作为零）

开启包括 Null 值（作为零） 设置，让 Looker 将 null 值视为零。将 null 值视为零有助于消除计算中的数学错误，避免可视化图表中出现空白，并确保指标聚合的准确性。

多条规则

您可以为条件格式设置多条规则。如需添加规则，请按以下步骤操作：

1. 如需添加规则，请点击 add_circle 添加规则。
2. 如果您有多条规则，列表中位置较靠前的规则优先于列表中位置较靠后的规则。如需更改规则的优先级，请点击规则的 drag_handle 拖动控柄，然后将规则在列表中向上或向下拖动。
3. 如需删除规则，请点击 delete 删除规则。

格式

对于每条规则，请使用格式 菜单选项选择以下规则选项之一：

• 介于
• 等于
• 大于
• 小于
• 不在之间
• 不等于
• 不为 null
• null

然后，根据您的选择，在显示的文本字段中输入比较值。在规则中输入值时，请勿使用千位分隔符。

注意： **介于** 、**不在之间** 、**大于** 和**小于** 等格式值范围不包括该范围边界处列出的数字。例如，如果您设置的规则范围为如果值介于 9 和 14 之间，则该规则适用于 10 到 13 之间的值。

样式

点击背景颜色 或字体颜色 旁边的色样，打开颜色选择器菜单，您可以在其中选择或自定义颜色：

• 如需从调色板中选择颜色，请点击颜色选择器菜单的调色板 标签页，然后使用向左和向右箭头滚动浏览可用的调色板。点击调色板中的颜色即可选择颜色。
• 如需选择自定义颜色，请点击调色板选择器的自定义 标签页，然后使用颜色渐变和值滑块选择自定义颜色，或者在输入字段中输入 RGB 十六进制字符串（例如 #2ca6cd）或 CSS 颜色名称（例如 mediumblue）。

相关资源

现在您已了解如何在 Looker 中创建 KPI（单值）可视化图表，接下来您可能需要了解如何执行以下操作：

• 将探索查询另存为 Look。
• 将探索查询添加到信息中心。
• 与其他用户共享数据。