持续集成 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 消息的最低严重程度级别,如果 LookML 消息的严重程度达到该级别,就会导致 CI 运行在 CI 运行页面CI 运行结果页面上显示 Failed CI 状态

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

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

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

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

超时

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