Looker 包含强大的原生可视化类型列表,可让您以多种方式绘制数据图表。如果您需要的图表类型未包含在 Looker 的原生可视化类型中,Looker 提供了多种方法供您向 Looker 实例添加自定义 JavaScript 可视化图表:
- 向 LookML 项目的清单文件中添加
visualization
参数,以直接将自定义可视化图表添加到 LookML 项目中。如需了解详情,请参阅visualization
参数文档页面。 - 从 Looker Marketplace 安装可视化图表。启用 Looker Marketplace 功能后,您可以安装 Looker Marketplace 插件,包括可添加到 Looker 原生可视化库的可视化类型。如需详细了解如何从 Looker Marketplace 安装插件,请参阅使用 Looker Marketplace 文档页面。如需了解如何创建可添加到 Looker Marketplace 并可供其他 Looker 用户访问的可视化图表,请参阅为 Looker Marketplace 创建自定义可视化图表文档页面。
- 您可以使用 Looker 管理菜单平台部分的可视化图表页面,从 Looker 的自定义可视化图表代码库中安装和管理自定义 JavaScript 可视化图表。
本页介绍了如何使用 Looker 管理面板中的可视化图表页面添加自定义 JavaScript 可视化图表。
自定义可视化图表是由社区提供支持的。Looker 的支持团队不会排查与自定义可视化图表或自定义可视化图表代码相关的问题。如需跟踪和查明 bug,请使用自定义可视化图表代码库中的 GitHub 问题,或访问 Looker 社区,查看有关自定义可视化图表的方法帖子、对话和提示。
您可以通过 Looker Marketplace 下载受支持的可视化图表。
查看自定义可视化图表列表
为了确保下载的可视化图表能够完全正常运行,由客户托管的部署的管理员应确保安装相应版本的 Chromium 渲染程序。
在 Looker 管理菜单的平台部分,可视化图表页面列出了已添加到 Looker 实例的所有自定义可视化图表。
该列表包含以下各列:
- ID:分配给自定义可视化图表的唯一 ID。在 JavaScript 代码中,或者在您使用管理页面添加或修改可视化图表时分配此值;或者在您使用 LookML 项目清单文件添加可视化图表时,在可视化图表的
id
参数中分配此值。 - 标签:在 Looker 可视化图表菜单中为可视化图表类型指定的名称。当您使用“管理”页面添加或修改可视化图表时,或者当您使用 LookML 项目清单文件添加可视化图表时,在可视化图表的
label
参数中分配此值。 - 主要:可视化图表的主要 JavaScript 代码的 URI。当您使用“管理”页面添加或修改可视化图表时,或者当您使用 LookML 项目清单文件添加可视化图表时,在可视化图表的
url
参数中分配此值。 - 操作:用于修改或删除可视化图表配置的按钮。对于使用 LookML 项目的清单文件添加的可视化图表,系统不会显示这些按钮。如需修改这些可视化图表,请转到 LookML 项目的清单文件并直接修改
visualization
参数。
添加新的自定义可视化图表
您可以在 Looker 的 Marketplace 中找到 Looker 的 Viz Blocks 列表。Looker 还在此 Looker GitHub 页面上维护了一个自定义可视化图表库,供公众使用。如需了解如何使用 Looker 的可视化 API 创建您自己的可视化类型,请参阅此 Looker GitHub 页面。
确定要向实例中添加的可视化图表后,您可以使用可视化图表页面来添加自定义可视化图表,只需选择页面左上角的添加可视化图表按钮即可。
Looker 会显示新建可视化:页面。如需添加新的可视化图表,请执行以下步骤:
在“ID”字段中,输入可视化图表 JavaScript 中定义的可视化图表的唯一 ID。
在标签字段中,输入可视化图表的名称。Looker 会在“探索”的 Looker 可视化菜单中显示此名称。
在主要字段中,输入可视化图表的主 JavaScript 文件的 URI,将 Looker 指向您的 JavaScript 代码库。
如果托管您的自定义可视化图表代码的网站使用子资源完整性 (SRI) 哈希进行验证,请在 SRI 哈希字段中输入 SRI 哈希。此字段可在高级选项下找到。Looker 的自定义可视化图表主机不使用 SRI 哈希。
在 Dependencies 字段中,输入可视化 JavaScript 依赖的任何其他文件的 URI,然后点击添加。您可以输入多个 URI(以英文逗号分隔),也可一次添加多个 URI。您可以在高级选项下找到依赖项字段。
选择保存。
添加可视化图表后,您就可以在“探索”的“可视化图表”菜单中看到它们,即您之前为其添加了标签。您可以像使用 Looker 现有的任何可视化类型一样使用新的可视化类型。
如需从“可视化图表”菜单中查看自定义可视化图表,请执行以下操作:
从可视化图表菜单栏中选择
...
三点状图标,即可访问自定义可视化图表。选择可视化图表后,可视化图表的名称会显示在可视化图表菜单栏中。
修改自定义可视化图表
要修改现有的可视化图表,请选择其右侧的修改按钮。Looker 显示您用于添加可视化图表的页面(相关说明见添加新的自定义可视化图表),但其中已经填充了相关信息。根据需要进行更改,然后点击保存。
删除自定义可视化图表
要删除可视化图表,请选择可视化图表右侧的删除按钮,然后点击确认框中的确定。删除可视化图表会将其从 Looker 中移除,但不会影响可视化图表外部代码库中的任何内容。
删除可视化图表会停用使用该可视化图表类型的所有 Look 或信息中心。要解决此问题,您可以重新添加具有相同可视化图表 ID 的已删除可视化图表。