验证 LookML

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

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

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

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

运行验证

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

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

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

验证消息

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

未找到任何 LookML 错误

如果验证器未发现任何问题,Looker 会显示一个绿色对勾标记,并显示未找到任何 LookML 错误字样。

LookML 错误

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

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

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

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

Chat 团队提示:我们最常询问的验证错误是“未知或无法访问的字段”。如需了解原因和解决方法,请访问错误:未知或无法访问的字段最佳实践页面。

LookML 警告

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

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

与 LookML 错误一样,您可以展开警告并跳转到问题代码,只需在项目健康状况面板中选择相应警告,然后将鼠标悬停在红色 X 图标上即可查看更多信息:

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

部署更改

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