验证 LookML

当您修改 LookML 时,Looker IDE 会提醒您注意单个文件中有任何未解决的语法错误(请参阅 Looker IDE 概览文档页面)。

如需执行完整的模型验证,请使用 LookML 验证器。某些错误(例如由于缺少联接而导致字段引用无效)需要全面审视模型,因此只有在运行 LookML 验证器时才会显示。请务必先验证 LookML 更改,然后再将其发布到生产环境。虽然验证无法捕获所有问题(例如数据库权限问题),但可以防止大多数错误出现。

LookML 验证工具仅扫描自上次 LookML 验证以来已更新的 LookML 文件,或受更新影响的文件:

  • 如果模型级设置发生变化,系统会再次验证所有内容。
  • 如果视图发生更改,系统只会重新验证使用该视图的探索。
  • 如果“探索”发生变化,则只有该“探索”会再次经过验证。

正在运行验证

如需运行 LookML 验证程序,请选择 Looker IDE 右上角的验证 LookML 按钮;或者,选择 IDE 顶部的 Project Health 图标以打开 Project Health 面板,然后点击 Verify LookML 图标。

运行 LookML 验证程序后,您可能会看到应解决的错误和其他警告的列表。您可以选择任意箭头,以展开错误或警告列表。

如果您进行其他更改并保存,Project Health 面板中的验证工具按钮将再次可用。

验证消息

Looker 在 LookML 上运行验证后会显示验证消息。

未发现任何 LookML 错误

如果验证工具未发现任何问题,Looker 会显示一个绿色对勾标记以及文本 No LookML errors found(未找到 LookML 错误)。

LookML 错误

LookML 错误是可能会阻止查询运行的问题。括号中的数字是发现的错误数量(在以下示例中为 9 个):

包含“LookML 错误 (9)”文字的验证消息示例。

在展开的问题列表中,您会看到未通过验证的原因。很多时候,如果您点击错误,便会直接进入有问题的代码行。您会在相应行旁边看到一个红色的“X”。在某些情况下,将鼠标悬停在错误标题上会提供更详细的错误信息:

悬停没有值的类型参数定义时所显示的错误示例,其中的错误文本指出您必须提供该类型的值。

聊天团队提示:我们最常被问到的是“未知或无法访问的字段”验证错误。请访问错误:未知或无法访问的字段“最佳做法”页面,了解具体原因和解决方法。

LookML 警告

LookML 警告可能不会阻止运行查询,但仍可能会导致用户无法使用某些功能或使用功能时出现意外情况。与错误一样,括号中的数字是找到的警告数量(在以下示例中为三个警告):

包含文本“LookML 警告 (3)”的验证消息示例。

与 LookML 错误一样,您可以在 Project Health 面板中选择警告,然后将鼠标悬停在红色 X 图标上以查看更多信息,从而展开警告并跳转到问题代码:

警告示例,其中文本指示“探索”必须与视图名称匹配,或者“探索”必须具有 from 或 view_name 属性。

部署更改

验证更改运行正常后,您可以使用 Looker 的 Git 集成将更改提交并部署到生产环境