借助 Looker 持续集成 (CI),如果您手动触发新运行的套件或重新运行之前的 CI 运行,Looker IDE 会自动显示手动运行的运行结果页面。否则,无论以何种方式触发运行,具有 see_ci
权限的 Looker 用户都可以通过 Looker IDE 中的运行页面访问运行结果:
运行页面会列出 LookML 项目的 CI 运行,以及以下信息:
- 状态:运行的状态:
- Queued:相应运行正在等待另一个 CI 运行完成,然后才会开始。
- 正在运行:CI 套件定义的验证器正在运行。
- 通过:CI 套件中的所有验证程序都已成功完成,并且没有一个验证程序返回错误。
- 失败:CI 套件中的所有验证器都已成功完成,但至少有一个验证器返回了错误。
- 错误:CI 套件中的一个或多个验证器未能运行。
- 已取消:CI 运行已取消。
- 套件:CI 套件的名称。
- 触发器:测试套件的触发方式(手动、拉取请求或 API)。
- Git 状态:有关在运行中验证的分支或提交的信息:
- 对于手动运行,该值为“生产环境”或开发分支的名称。
- 对于由拉取请求触发的运行,该值是指向拉取请求的提交 SHA 的超链接。点击提交 SHA 超链接,在另一个浏览器标签页中打开拉取请求。
- 触发时间:CI 运行的启动时间。
CI 运行结果
在运行页面上,点击某个 CI 运行对应的查看运行按钮,即可查看其验证结果:
CI 套件的运行结果页面会显示以下信息:
- 运行验证的 LookML 项目和 Git 详细信息(以及由拉取请求触发的运行的提交)。
- 有关 CI 运行的信息:
- 运行的触发方式和时间。
- 发起运行的 Looker 用户(对于手动运行)或分支和提交(对于由拉取请求触发的运行)。
- CI 运行完成所花费的时间。
- 运行在队列中等待的时间(以秒为单位),然后才开始运行。
- 对于返回错误的验证程序,结果页面会显示每项错误以及错误消息和指向 LookML、探索或内容的链接,以便您测试和更正每项错误。
- 对于未发现任何错误的验证器,结果页面会显示成功消息。
查看增量验证的结果
对于配置为增量验证的 CI 验证器运行(针对 SQL 验证器或内容验证器),验证器将仅返回开发分支或 pull 请求提交中存在的错误;如果错误已存在于生产版本中,则启用增量验证的验证器不会返回错误。
以下是 SQL 验证器的增量验证结果页面示例:
- 结果页面仅显示开发分支或提交中存在的错误。
- 如果探索在开发分支或提交中没有任何更改,验证器将在验证期间跳过该探索。这些探索会在验证器结果中标记为“已跳过”。
- 在验证结果中,以增量方式运行的验证器会标记为“增量”。