持续集成 LookML 验证器

对于所有开发者都在 Looker IDE 中工作的 LookML 项目,在将项目部署到生产环境的过程中,系统会内置 LookML 验证。但对于部分或全部开发者在 Looker IDE 之外工作(使用外部 IDE(如 VSCode 或 Vim)编写 LookML)的 LookML 项目,您可能会在从未验证 LookML 语法的情况下将项目部署到生产环境。在这种情况下,您可以运行持续集成 (CI) LookML 验证器,以查找 LookML 中的语法问题,例如缺少 } 或无效的 ${} 引用。

如需详细了解在创建或修改 CI 套件时可以配置的选项,请参阅本页面的LookML 验证器选项部分。如需了解如何运行 LookML 验证器,请参阅运行持续集成套件文档页面。

运行结果页面 中,LookML 验证器会提供项目中的 LookML 错误,以及 LookML 的链接:

显示 LookML 验证器发现结果的持续集成结果页面

LookML 验证器选项

以下部分介绍了运行 LookML 验证器的选项:

设置严重级别阈值

严重级别设置决定了 LookML 消息的最低严重级别,该级别将导致 CI 运行在 CI Runs 页面CI 运行结果页面 上显示 Failed CI status

在 Looker IDE 中,LookML 验证会返回三个严重级别的语法消息:信息、警告错误

默认情况下,只有当 LookML 验证器在 LookML 项目中发现 LookML 警告或错误时,LookML 验证器才会导致 Failed CI 状态。您可以选择 CI LookML 验证器应返回 Failed 结果的最低级别消息严重级别:

  • Error:如果 LookML 验证返回错误消息,CI LookML 验证器将返回 Failed 结果。
  • Warning:如果 LookML 验证返回警告或错误消息,CI LookML 验证器将返回 Failed 结果。
  • 信息:如果 LookML 验证返回信息、警告或错误消息,CI LookML 验证器将返回 失败 结果。

此严重级别阈值仅影响 CI 运行状态值。无论严重级别设置如何,LookML 验证器结果都会显示所有语法问题,并在 CI 运行结果页面上显示所有 LookML 语法消息。

超时

您可以指定 CI LookML 验证器在超时之前应运行的秒数(默认值为 600 秒)。如果 CI LookML 验证器花费的时间超过超时时长,验证将放弃作业并返回 Error 运行状态。