継続的インテグレーションの Assert バリデータ

継続的インテグレーション(CI)Assert Validator は、LookML データテストを LookML デベロッパーが LookML プロジェクトで作成し、各データテストの結果を表示します。データテストが失敗した場合、Assert Validator はエラーを表示します。

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 Validator オプションのセクションをご覧ください。Assert Validator の実行については、継続的インテグレーション スイートの実行のドキュメント ページをご覧ください。

実行結果ページで、Assert Validator は各データテストの結果を表示します。データテストが失敗した場合、Assert Validator は次のようにエラーを表示します。

アサート バリデータの結果を示す継続的インテグレーションの結果ページ

Assert Validator オプション

継続的インテグレーション スイートを作成または編集するときに、Assert Validator の実行方法を構成するオプションをいくつか指定できます。オプションについては、このページの次のセクションで説明します。

クエリを実行する Explore

デフォルトでは、Assert Validator は LookML プロジェクトの各データテストを実行します。

データテストは、プロジェクト内の Explore を指す explore_source パラメータを使用して定義されます。[クエリを実行する Explore] フィールドを使用すると、データテストのベースとなる特定の Explore にアサート検証を制限できます。

Explore は model_name/explore_name の形式で指定できます。

たとえば、thelook.model.lkml ファイルで usersorders という名前の Explore を指定するには、次の値を入力します。thelook/users, thelook/orders

このフィールドで Explore とモデルを指定する方法の詳細と例については、SQL Validator のドキュメント ページをご覧ください。

除外する Explore

デフォルトでは、Assert Validator は LookML プロジェクトの各データテストを実行します。[除外する Explore] フィールドを使用すると、データテストのベースとなる特定の Explore をアサート検証から除外できます。Assert Validator は、除外された Explore に基づくデータテストを実行しません。

Explore は model_name/explore_name の形式で指定できます。

このフィールドで Explore とモデルを指定する方法の詳細と例については、SQL Validator のドキュメント ページをご覧ください。

クエリの同時実行数

デフォルトでは、Assert Validator は Looker インスタンスに過負荷がかからないように、一度に 10 個以下のクエリを実行します。[クエリの同時実行数] フィールドを使用すると、Assert Validator が同時に実行できるクエリの最大数を指定できます。

[**クエリの同時実行数**] フィールドの最大値は、データベース接続の [この接続に関する同時実行クエリの最大数] 設定に制限されます。

Assert 検証の実行中に Looker インスタンスの速度が低下した場合は、この値を小さくしてください。