可视化

用法

visualization: {
  id: "unique-id" 
  label: "Visualization Label" 
  url: "visualization_url" 
  sri_hash: "SRI hash" 
  dependencies: ["dependency_url_1","dependency_url_2"]
  file: "visualization_file_path" 
}
层次结构
visualization
默认值
无

特殊规则
visualization 必须包含 url 或 file 参数，但不能同时包含这两者

定义

visualization 参数可向 LookML 项目添加自定义可视化图表，用户可以通过项目中的“探索”的可视化图表标签页访问该图表。自定义可视化图表必须在 JavaScript 文件中定义，该文件可以包含在 LookML 项目文件中，也可以托管在其他位置。

visualization 参数具有以下子参数：

参数 说明
id 指定可视化图表的唯一标识符，该标识符显示在 Looker 的管理菜单的可视化图表页面中。
label 提供可视化图表的标签，该标签会显示在项目的探索的可视化图表标签页中，以及 Looker 的管理菜单的可视化图表页面中。
url 如果可视化图表的 JavaScript 文件存储在 Looker 实例之外的服务器上，url 参数会提供该文件的网址。除了使用 url 参数之外，您还可以将文件拖放到 Looker IDE 中，然后使用 file 参数指向该文件。

NOTE：应用必须具有 url 参数或 file 参数，但不能同时具有这两个参数。
sri_hash 仅当使用 url 参数指定可视化图表的 JavaScript 文件时，才会使用 SRI 哈希。如果托管自定义可视化图表代码的网站使用子资源完整性 (SRI) 哈希进行验证，请在 sri_hash 字段中输入 SRI 哈希。
dependencies 提供以英文逗号分隔的加载可视化图表所需的依赖项网址列表。
file 指定定义可视化的 JavaScript 文件（扩展名为 .js）的路径。该路径相对于项目根目录。下一列中的示例指向 LookML 项目的 visualizations 目录中的 calendar-heatmap.js 文件。

NOTE：应用必须具有 url 参数或 file 参数，但不能同时具有这两个参数。

示例：向 LookML 项目添加自定义可视化图表网址

向 LookML 项目添加自定义可视化的一个方法是使用自定义可视化文件的网址。例如，将以下 LookML 添加到项目的清单文件后，Looker 项目中会添加一个多值 CDN 自定义可视化图表。此可视化图表在 Looker Marketplace 上的 JavaScript 文件中定义：

visualization: {
  id: "spider-marketplace-dev"
  label: "Spider Viz"
  url: "https://marketplace-api.looker.com/viz-dist/spider.js"
  sri_hash: "oqVuAfXRKap7fdgcCY5uykM6+R9GqQ8K/uxy9rx7HNQlGYl1kPzQho1wx4JwY8wC"
  dependencies: ["https://code.jquery.com/jquery-2.2.4.min.js","https://cdnjs.cloudflare.com/ajax/libs/underscore.js/1.9.1/underscore-min.js","https://cdnjs.cloudflare.com/ajax/libs/d3/3.5.6/d3.min.js","https://cdnjs.cloudflare.com/ajax/libs/d3-legend/1.13.0/d3-legend.min.js"]
}

提交更改并将其部署到生产环境后，Looker 会在项目的探索的可视化图表标签页中将自定义可视化图表的名称显示为一个选项。

可视化图表也会列在 Looker 的管理菜单中平台部分的可视化图表页面上；如需了解相关信息，请参阅管理设置 - 可视化图表文档页面。

示例：向 LookML 项目添加自定义可视化图表文件

另一种方法是使用 Looker IDE 将自定义可视化图表 JavaScript 文件添加到 LookML 项目中：

  1. 在 Looker IDE 中，将定义自定义可视化的 JavaScript 文件拖放到 LookML 项目中。
  2. （可选）将可视化图表文件移至 Looker IDE 中的文件夹，或为可视化图表文件创建新文件夹。
  3. 在文件浏览器面板中点击可视化图表文件以显示文件内容，然后点击保存以保存文件。
  4. 在项目的清单文件中，定义可视化图表参数。例如，以下 LookML 会向 Looker 项目添加径向仪表自定义可视化图表。可视化图表是在 LookML 项目的 visualizations 目录中的 JavaScript 文件中定义的：
  visualization: {
  id: "radial_gauge"
  label: "Radial Gauge"
  file: "visualizations/radialgauge_v2.js"
   }

  1. 提交您的更改，并将其部署到生产环境。

    您必须部署可视化图表更新，才能在探索中看到客户可视化图表选项（即使在开发模式下，仅保存更新也不够）。

部署更新后，Looker 会在项目的“探索”的可视化图表标签页中将自定义可视化图表的名称显示为一个选项。

可视化图表也会列在 Looker 的管理菜单中平台部分的可视化图表页面上；如需了解相关信息，请参阅管理设置 - 可视化图表文档页面。