内容验证

内容验证器会在 LookML 中搜索 Looker 内容中引用的模型、探索和字段名称。该工具非常有用,可用于验证 LookML 引用、在您更改 LookML 后修复其中的错误,以及更新项目中 LookML 元素的名称。

您必须拥有 develop 权限,才能使用内容验证器。

如需打开内容验证工具,请从左侧导航面板开发菜单中选择内容验证工具。您可以通过以下两种方式使用内容验证器:

使用内容验证器前的注意事项

使用内容验证功能进行更改时,您必须格外小心。内容验证器没有撤消功能,并且可能会影响许多 Look 和信息中心以及其从此处探索链接。如果您确实有误,应尽快尝试更正,以免后续更改导致难以分离出受影响的 Look。

另外,在使用内容验证器时,请考虑时间安排。将开发更改推送到生产环境时,您应大约同时修复受影响的 Look 和图块,使其在最短时间内被损坏。如果您根据您在开发模式下所做的工作过早修正 Look 和图块,它们将对用户显示不正常,直到您推送更改。同样,如果您延迟很长时间才修复 Look 和图块,直到推送更改后很长一段时间,那么在您修复它们之前,它们对用户而言都将是损坏的。

使用内容验证程序修正错误

内容验证器是一款实用工具,可用于查找和修复因 LookML 中的更改而导致的错误。例如,如果您将字段名称从 customer 更改为 user,则包含 customer 字段的任何外观或信息中心功能块都将无法正常运行(除非您使用了 alias 参数)。内容验证器会列出对 customer 字段的所有引用,并提供一种简便的方法来修正错误。

当您运行内容验证器时,它会验证您的数据集和信息中心对 LookML 模型探索视图字段的所有引用,并会针对内容对未知 LookML 对象的任何引用显示错误。

内容验证工具不会显示以下方面的错误:

  • 你没有 develop 权限的内容。内容验证器的适用范围仅限于您的权限,因此您只能对具有 develop 权限的内容(可在 Looker IDE 中看到的模型)使用内容验证器。如需了解模型权限,请参阅角色文档页面。
  • 已删除且位于回收站中的外观。如果要验证已删除的 Look,您的 Looker 管理员必须先恢复该 Look。

运行内容验证器

如需使用内容验证器验证 LookML,请执行以下操作:

  1. 点击验证
  2. 选择分组依据标签页可更改错误的分组方式:
    • 错误:列出每个错误,并将包含错误的 Looker 内容分组在一起。如果您想一次修正多个内容中的同一错误,此方法会非常有用。
    • 文件夹:列出每个文件夹,将存在错误的 Looker 内容分组在一起。如果您只想修复特定文件夹中的错误,此方法会非常有用。
    • 内容:列出存在错误的每条内容,并将其错误归为一组。如果您想在单个 Look、图块、滤镜等中修复所有错误,这会非常有用。
  3. 如果您处于开发模式,Looker 会显示一条警告消息。了解更改 Look 和图块的影响非常重要。如果您在发布破坏性更改之前“修正”了这些问题,那么在修正生效之前,用户会遇到破损的外观或功能块。警告消息可帮助您记住这一点。
  4. 错误表会显示所有错误,以及包含错误的“外观”和功能块的列表,以及产生错误的底层模型和“探索”。您可以使用页面右上角的分组依据标签页来更改错误表格的布局。
  5. Looker 会为每行提供替换和/或移除按钮,具体取决于错误类型。这些按钮提供了用于修正错误的功能,使用内容验证器修正错误中对此进行了更详细的介绍。

查看内容验证结果

内容验证结果会显示使用不存在或无法找到的模型名称、探索名称、视图名称或字段名称的 Looker 内容。如需详细了解内容验证器可以找到和验证的 LookML 元素,请参阅使用内容验证器修正错误部分。

内容名称旁边的图标用于标识内容类型:

  • 信息中心上的功能块图标。 - 信息中心图块
  • 信息中心上的提醒图标。 - 信息中心提醒
  • “在信息中心中安排”或“在 Look 中安排”图标。 - 为信息中心或 Look 安排发送时间
  • “按信息中心过滤”图标。 - 数字面板的过滤条件,或监听数字面板过滤条件的功能块中的字段(如需了解如何配置功能块以监听数字面板过滤条件,请参阅添加和修改用户定义的数字面板过滤条件文档页面)

验证结果基于您在运行验证器时所处模式下可用的 LookML。如果您使用的是“正式版”模式,验证结果将反映已推送到正式版的所有 LookML。如果您使用的是开发模式,验证结果将反映您已保存的 LookML,即使该 LookML 尚未推送到生产环境也是如此。

错误可能是由于 LookML 中的故意更改以及拼写错误或缺少联接而导致的。

要调整错误,您可以使用错误表中每一行中的替换移除按钮,如下所示:

  • 替换:Looker 为每个错误提供替换按钮(请参阅本页后面的替换字段、视图、探索和模型的名称部分,了解如何使用内容验证器替换名称)。
  • 移除:对于 Look 或图块的数据部分中的字段名称错误,Looker 还会显示移除按钮(请参阅本页后面的移除字段名称部分,了解如何使用内容验证器移除名称)。

这些按钮会应用于单个项(外观或功能块),或多个项,具体取决于您的按属性分组设置:

  • 如果您按错误分组,这些按钮会应用于 Looker 实例上所有 Look 和图块中出现的相应错误,这样只需一次操作即可修复出现的所有错误。
  • 如果您按文件夹内容分组,这些按钮会应用于单个 Look 或图块中出现的一次错误,以便您分别考虑每次出现的错误。

例如,某个错误表格按错误分组,显示了包含名为 customers 的未知“探索”内容的 3 个内容实例。为这三部分内容提供的操作是 Replace。点击替换会影响包含错误 3 x Unknown explore 'customers' 的所有三个内容实例。

在某些情况下,一项内容可能会出现多个错误。例如,错误表格按内容分组,并显示名为订单详情的内容。错误列中显示了四个 Unknown field 错误,每个错误在操作列中都有自己的替换移除操作按钮。

此外,如果您按内容分组,您还可以选择删除 Look

替换字段、视图、探索和模型的名称

内容验证结果会针对以下类型的元素显示替换按钮,以便您重命名这些元素:

对于上述任何错误,您都可以使用内容验证工具替换掉一个与出错属性相同或更宽泛的内容属性:

  • 如果某个字段出现错误,您可以替换/移除该字段,也可以替换视图、“探索”或模型名称。
  • 如果“探索”名称出错,您可以替换“探索”名称或型号名称。
  • 如果模型名称有误,您可以替换模型名称。

下面介绍了如何使用内容验证器替换模型中元素的名称:

  1. 点击验证以运行内容验证器。
  2. 选择分组依据设置可选择错误的分组方式。例如,您可以按错误分组,以便同时调整多项内容。
  3. 在错误表格中,点击要更正的错误旁边的替换按钮,以打开更新内容对话框。

  4. 更新内容对话框的类型部分中,选择要更改的 LookML 元素的类型:字段、视图、“探索”或模型。Looker 会针对每个错误显示适当的选项。

  5. 名称部分中,确认您要替换的项的名称。内容验证工具会自动填充此信息。

  6. 替换名称部分,输入商品的新名称。

  7. 如果您按错误进行分组,并且有多个项目会受到影响,您可以点击显示内容,查看内容验证程序将更新的项目列表。

  8. (可选)您可以清除任何列出的项旁边的复选框,以保留其名称。

  9. 如要进行更改,请点击替换

移除字段名称

如果 Look 或图块的数据部分中的字段名称存在错误,错误表会在错误右侧提供一个移除按钮。您可以使用内容验证器移除以下字段:

  • 在“数据”部分中查看数据
  • 在可视化图表配置中引用,例如柱形图的系列标签页的自定义区域
  • 由信息中心图块引用,以监听信息中心过滤条件(在过滤条件配置窗口的要更新的图块标签页中配置,如添加和修改用户定义的信息中心过滤条件文档页面中所述)

您无法使用内容验证器从自定义过滤条件自定义字段表格计算中移除字段,因为通常您需要进行其他更改才能让表达式正常运行。而是使用内容验证错误消息来查找需要修正自定义过滤器、自定义字段和表计算表达式的位置,然后酌情重新编写相应表达式。

  1. 点击验证以运行内容验证器。
  2. 选择分组依据设置可选择错误的分组方式。例如,您可以按错误分组,以便同时调整多项内容(外观和/或图块)。
  3. 在错误表格中,点击要更正的字段错误旁边的移除,以打开从内容中移除字段对话框。

  4. 从内容中移除字段对话框的字段部分,验证要移除的项目的名称。内容验证器会自动填写此字段。

  5. 如果您已按错误分组且有多个项(Look 和/或图块),您可以点击显示内容以查看内容验证器将更新的项列表。

  6. (可选)您可以清除任何外观或功能块旁边的复选框,以保持其名称不变。

  7. 点击移除字段以进行更改。

删除 Look

如果您按内容对错误表进行分组,则可以选择删除表格中的外观。

如需使用内容验证器删除 Look,请执行以下操作:

  1. 点击验证以运行内容验证器。
  2. 内容对表格进行分组。
  3. 在错误表中,点击要删除的一个或多个 Look 旁边的选择复选框。
  4. 点击删除所有所选外观
  5. 点击确认框中的 OK(确定)以删除所选的妆容或妆容。

使用内容验证器查找和替换

内容验证器还可用于搜索和替换模型、探索和字段的名称。例如,您可能决定更喜欢某个字段,并希望在项目中进行替换,即使没有错误也是如此。如需查看内容验证器可以搜索/替换的元素的完整列表,请参阅替换字段、视图、探索和模型的名称部分。

若要将内容验证器用作查找和替换工具,请执行以下操作:

  1. 在“内容验证工具”屏幕上,点击查找和替换为“所有内容”以打开更新对话框。
  2. 选择您要更改的 LookML 元素的类型(字段、视图、探索或模型)。
  3. 输入要替换的项的名称
  4. 为字段、视图、“探索”或模型输入替换名称
  5. 点击替换进行更改。

需要考虑的事项

请计划重新运行内容验证,以查看您所做的任何修正的结果。

关于内容验证器,请注意以下几点:

  • 对于视图、探索或模型,您可以更改其名称,但不能彻底移除它们的名称。请参阅移除字段名称部分,查看您可以使用内容验证器移除的项目列表。
  • 表格计算只能引用查询中包含的 Look 或图块的字段。这意味着,如果您从数据卡片或图块的查询中移除某个字段,但表格计算仍使用该字段,则会收到新的内容验证错误。
  • 已删除且位于回收站页面中的外观不会经过验证。如果要验证已删除的 Look,您的 Looker 管理员必须先恢复该 Look。
  • 如果您处于开发模式,则验证结果会反映您保存的 LookML,即使它尚未推送到生产环境也是如此。不过,您使用内容验证器所做的任何更改都会影响在正式版模式下观看内容的用户。建议您在运行内容验证器之前先切换到生产环境模式。