持续集成 (CI) 断言验证器会运行 Looker 开发者在您的 LookML 项目中创建的 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 套件时可以配置的选项,请参阅本页的断言验证器选项部分。如需了解如何运行断言验证器,请参阅运行持续集成套件文档页面。
在运行结果页面中,断言验证器会显示每项数据测试的结果。对于失败的数据测试,断言验证器会显示错误,如下所示:
断言验证器选项
在创建或修改持续集成套件时,您可以指定多个选项来配置 Assert 验证程序的运行方式。本页的以下部分介绍了这些选项:
要查询的探索
默认情况下,断言验证器会运行 LookML 项目中的每个数据测试。
数据测试使用指向项目中探索的 explore_source
参数进行定义,您可以使用要查询的探索字段将断言验证限制为基于数据测试的特定探索。
您可以按以下格式指定探索:model_name/explore_name
例如,如需在 thelook.model.lkml
文件中指定名为 users
和 orders
的探索,您需要输入以下内容:thelook/users, thelook/orders
如需详细了解如何在此字段中指定 Explore 和模型,以及相关示例,请参阅 SQL 验证器文档页面。
要排除的探索
默认情况下,断言验证器会运行 LookML 项目中的每个数据测试。您可以使用要排除的探索字段,从断言验证中排除数据测试所依据的特定探索。Assert 验证器不会运行基于这些已排除的探索的数据测试。
您可以按以下格式指定探索:model_name/explore_name
如需详细了解如何在此字段中指定 Explore 和模型,以及相关示例,请参阅 SQL 验证器文档页面。
查询并发
默认情况下,断言验证器一次最多运行 10 个查询,以免使您的 Looker 实例过载。您可以使用查询并发数字段指定断言验证器可以并发运行的查询数量上限。
查询并发字段的最大值受数据库连接的此连接的并发查询数上限设置的限制。
如果您在运行断言验证时发现 Looker 实例运行缓慢,可以降低此值。