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