継続的インテグレーション（CI）Assert Validator は、Looker デベロッパーが LookML プロジェクトで作成した LookML データテストを実行し、各データテストの結果を表示します。データテストが失敗すると、Assert Validator にエラーが表示されます。
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 Validator の実行については、継続的インテグレーション スイートの実行のドキュメント ページをご覧ください。
実行結果ページの Assert Validator に、各データテストの結果が表示されます。データテストが失敗した場合、Assert Validator には次のようにエラーが表示されます。
Assert Validator のオプション
継続的インテグレーション スイートを作成または編集するときに、Assert Validator の実行方法を構成するために指定できるオプションがいくつかあります。オプションについては、このページの次のセクションで説明します。
クエリするデータ探索
デフォルトでは、Assert Validator は LookML プロジェクト内の各データテストを実行します。
データテストは、プロジェクト内の Explore を指す explore_source パラメータを使用して定義されます。[クエリ対象の Explore] フィールドを使用すると、データテストの基になる特定の Explore にアサートの検証を制限できます。
Explore は次の形式で指定します。model_name/explore_name
たとえば、thelook.model.lkml ファイルで users という名前と orders という名前の Explore を指定するには、thelook/users, thelook/orders と入力します。
このフィールドで Explore とモデルを指定する方法の詳細と例については、SQL Validator のドキュメント ページをご覧ください。
除外する Explore
デフォルトでは、Assert Validator は LookML プロジェクト内の各データテストを実行します。[除外するデータ探索ツール] フィールドを使用すると、データテストの基になる特定のデータ探索ツールをアサート検証から除外できます。アサート検証ツールでは、除外されたデータ探索に基づくデータテストは実行されません。
Explore は次の形式で指定します。model_name/explore_name
このフィールドで Explore とモデルを指定する方法の詳細と例については、SQL Validator のドキュメント ページをご覧ください。
クエリの同時実行数
デフォルトでは、Assert Validator は Looker インスタンスの過負荷を回避するため、一度に 10 件以下のクエリしか実行しません。[クエリの同時実行] フィールドを使用して、Assert Validator が同時に実行できるクエリの最大数を指定できます。
[クエリの同時実行] フィールドの最大値は、データベース接続の [この接続に関する同時実行クエリの最大数] の設定に制限されます。
Assert 検証の実行中に Looker インスタンスの速度が低下した場合は、この値を減らすことができます。