持续集成断言验证器

持续集成 (CI) 断言验证器会运行 LookML 项目中由 Looker 开发者创建的 LookML 数据测试,并显示每项数据测试的结果。对于失败的数据测试,断言验证器会显示错误。

借助 LookML 数据测试,您可以验证 Looker 模型的逻辑。数据测试可以测试复杂的假设,例如:

  • 去年 5 月的收入应等于 204,259 美元。
  • 转化率应大于零。
  • 订单状态不应为 null。

LookML 数据测试由一个小型 explore_source 查询和一个 yesno 断言表达式组成,如以下示例所示:

test: historic_revenue_is_accurate {
  explore_source: orders {
    column: total_revenue { field: orders.total_revenue }
    filters: [orders.created_date: "2024"]
  }
  assert: revenue_is_expected_value {
    expression: ${orders.total_revenue} = 626000 ;;
  }
}

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

运行结果页面中,断言验证器会显示每项数据测试的结果。对于失败的数据测试,断言验证器会显示一个或多个错误,如下所示:

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

断言验证器选项

在创建或修改持续集成套件时,您可以指定多个选项来配置断言验证器的运行方式。本页面的以下部分介绍了这些选项:

要查询的探索

默认情况下,断言验证器将运行 LookML 项目中的每项数据测试。

数据测试是使用指向项目中探索的 explore_source 参数定义的,您可以使用要查询的探索 字段将断言验证限制为数据测试所基于的特定探索。

您可以按以下格式指定探索:model_name/explore_name

例如,如需指定 thelook.model.lkml 文件中名为 usersorders 的探索,您需要输入以下内容:thelook/users, thelook/orders

如需详细了解如何在此字段中指定探索和模型,以及相关示例,请参阅 SQL 验证器 文档页面。

要排除的探索

默认情况下,断言验证器将运行 LookML 项目中的每项数据测试。您可以使用要排除的探索 字段从断言验证中排除数据测试所基于的特定探索。断言验证器不会运行基于这些排除的探索的数据测试。

您可以按以下格式指定探索:model_name/explore_name

如需详细了解如何在此字段中指定探索和模型,以及相关示例,请参阅 SQL 验证器 文档页面。

查询并发数

默认情况下,断言验证器一次运行的查询不超过 10 个,以避免 Looker 实例过载。您可以使用查询并发数 字段指定断言验证器可以同时运行的其他查询数量上限。

查询并发数 字段的最大值受数据库连接的 此连接的并发查询数上限 设置的限制。

如果您在运行断言验证时发现 Looker 实例运行速度变慢,可以减小此值。