当您修改 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 个):
在展开的问题列表中,您会看到未通过验证的原因。很多时候,如果您点击错误,便会直接进入有问题的代码行。您会在相应行旁边看到一个红色的“X”。在某些情况下,将鼠标悬停在错误标题上会提供更详细的错误信息:
聊天团队提示:我们最常被问到的是“未知或无法访问的字段”验证错误。请访问错误:未知或无法访问的字段“最佳做法”页面,了解具体原因和解决方法。
LookML 警告
LookML 警告可能不会阻止运行查询,但仍可能会导致用户无法使用某些功能或使用功能时出现意外情况。与错误一样,括号中的数字是找到的警告数量(在以下示例中为三个警告):
与 LookML 错误一样,您可以在 Project Health 面板中选择警告,然后将鼠标悬停在红色 X 图标上以查看更多信息,从而展开警告并跳转到问题代码:
部署更改
验证更改运行正常后,您可以使用 Looker 的 Git 集成将更改提交并部署到生产环境。