持续集成 (CI) 断言验证器会运行 LookML 项目中由 Looker 开发者创建的 LookML 数据测试,并显示每个数据测试的结果。对于失败的数据测试,断言验证器会显示错误。
借助 LookML 数据测试,您可以验证 Looker 模型的逻辑。数据测试可以测试复杂的假设,例如:
- 去年 5 月的收入应为 204,259 美元。
- 转化率应大于 0。
- 订单状态不应为 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 套件时可以配置的选项,请参阅本页面的断言验证器选项部分。如需了解如何运行断言验证器,请参阅运行持续集成套件文档页面。
在运行结果页面中,Assert Validator 会显示每个数据测试的结果。对于失败的数据测试,Assert 验证器会显示错误,如下所示:
断言验证器选项
在创建或修改持续集成套件时,您可以指定多个选项来配置断言验证器的运行方式。本页面的以下部分介绍了这些选项:
要查询的探索
默认情况下,Assert 验证器将运行 LookML 项目中的每个数据测试。
数据测试使用指向项目中的 Explore 的 explore_source
参数进行定义,您可以使用用于查询的 Explore 字段将断言验证限制为基于数据测试的特定 Explore。
您可以按以下格式指定探索:model_name/explore_name
例如,如需指定 thelook.model.lkml
文件中名为 users
和 orders
的 Explore,您需要输入以下内容:thelook/users, thelook/orders
如需详细了解如何在相应字段中指定 explore 和模型,请参阅 SQL 验证器文档页面。
要排除的探索
默认情况下,断言验证器将运行 LookML 项目中的每个数据测试。您可以使用要排除的探索字段,从断言验证中排除数据测试所依据的特定探索。Assert 验证器不会运行基于这些排除的 Explore 的数据测试。
您可以按以下格式指定探索:model_name/explore_name
如需详细了解如何在相应字段中指定 explore 和模型,请参阅 SQL 验证器文档页面。
查询并发
默认情况下,为了避免 Looker 实例不堪重负,断言验证器一次最多运行 10 个查询。您可以使用查询并发数字段指定断言验证器可同时运行的查询数量上限。
查询并发字段的最大值受数据库连接的此连接的并发查询数上限设置限制。
如果您在运行断言验证时发现 Looker 实例运行速度变慢,可以降低此值。