持续集成 LookML 验证器

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

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

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

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

LookML 验证器选项

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

设置严重程度阈值

严重级别设置决定了 LookML 消息的最低严重级别,如果达到该级别,持续集成 (CI) 运行将在持续集成运行页面持续集成运行结果页面上显示失败持续集成状态

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

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

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

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

超时

您可以指定 CI LookML 验证器在运行多少秒后便会超时(默认值为 600 秒)。如果 CI LookML 验证程序的运行时间超过超时时长,验证将放弃作业并返回 Error 运行状态。