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