持续集成断言验证器

持续集成 (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 文件中指定名为 usersorders 的探索,您需要输入以下内容:thelook/users, thelook/orders

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

要排除的探索

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

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

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

查询并发

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

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

如果您在运行断言验证时发现 Looker 实例运行缓慢,可以降低此值。