継続的インテグレーション（CI）Content Validator は、エラーのあるダッシュボードと Look を特定します。多くの場合、これらのエラーは LookML フィールドへの参照がないことが原因で発生します。
CI Content Validator は、標準の Looker Content Validator と同様の検証を行いますが、次のような違いがあります。
CI Content Validator は以下をサポートしています。
- Looker デベロッパーが LookML リポジトリにプル リクエストを送信したときに自動的に実行されるように、または CI スイートを手動で実行したときに手動で実行されるように、CI Content Validator を構成できます。
- CI Content Validator の結果を、特定の Looker コンテンツ フォルダ、または LookML プロジェクト内の特定のモデルと Explore に限定できます。デフォルトでは、CI Content Validator の結果は LookML プロジェクトに自動的に限定されます。CI Content Validator のスコープ設定は事後処理です。バリデータは Looker インスタンス全体で実行され、CI スイートの作成時に指定したスコープに結果をフィルタします。
標準の Looker Content Validator は以下をサポートしています。
- Looker Content Validator は 手動でのみ 実行できます。
- Looker Content Validator を特定の Looker コンテンツ フォルダまたは特定の LookML プロジェクトに限定できます。Looker Content Validator のスコープ設定は検証前に行われます。バリデータは、コンテンツ検証を開始したときに指定したフォルダとプロジェクトでのみ実行されます。
- Looker Content Validator を使用して、フィールド、ビュー、Explore、モデルの名前の置換、フィールドの削除、Look の削除を行うことができます。
CI スイートの作成または編集時に構成できるオプションの詳細については、このページのContent Validator のオプションをご覧ください。Content Validator の実行については、継続的インテグレーション スイートを実行するのドキュメントページをご覧ください。
実行結果ページで、Content Validator は、エラーが発生した各 Look またはダッシュボードのエラー メッセージと、コンテンツへのリンクを表示します。
Content Validator のオプション
継続的インテグレーション スイートを作成するときに、Content Validator の実行方法を構成するオプションをいくつか指定できます。オプションについては、このページの次のセクションで説明します。
クエリを実行する Explore
デフォルトでは、Content Validator は LookML プロジェクト内のすべてのモデルと Explore でコンテンツ検証を実行します。
[クエリを実行する Explore] フィールドを使用して、コンテンツ検証に含める Explore とモデルを指定できます。
Explore は model_name/explore_name の形式で指定します。
たとえば、thelook.model.lkml ファイルで users と orders という名前の Explore を指定するには、次の値を入力します。thelook/users, thelook/orders
このフィールドで Explore とモデルを指定する方法の詳細と例については、SQL Validator のドキュメント ページをご覧ください。
除外する Explore
デフォルトでは、Content Validator は LookML プロジェクト内のすべてのモデルと Explore でコンテンツ検証を実行します。
[除外する Explore] フィールドを使用して、コンテンツ検証から除外する Explore とモデルを指定できます。
Explore は model_name/explore_name の形式で指定します。
このフィールドで Explore とモデルを指定する方法の詳細と例については、SQL Validator のドキュメント ページをご覧ください。
検証するフォルダ
フォルダ ID またはフォルダ ID のカンマ区切りのリストを指定して、Looker インスタンス上の特定のコンテンツ フォルダにコンテンツ検証の範囲を設定できます。
フォルダの ID を取得するには、Looker のメイン ナビゲーション メニューを使用してフォルダを開き、ブラウザの URL からフォルダ ID を取得します。フォルダ ID は URL の最後の要素です。たとえば、次の URL の場合、フォルダ ID は 45 です。
https://myinstance.looker.com/folders/45
除外するフォルダ
[除外するフォルダ] フィールドにフォルダ ID またはフォルダ ID のカンマ区切りのリストを指定して、特定のコンテンツ フォルダをコンテンツ検証から除外できます。
個人用フォルダのコンテンツを除外する
Content Validator で共有フォルダ内のコンテンツのみを検証する場合は、[個人用フォルダのコンテンツを除外する] フィールドを有効にします。[個人用フォルダのコンテンツを除外する] フィールドが有効になっている場合、Content Validator は Looker インスタンスの個人用フォルダ内のコンテンツを無視します。
増分検証
増分検証は、特定の開発ブランチに固有のエラー（本番環境にまだ存在しないエラー）を見つける方法です。増分検証を使用すると、デベロッパーはプロジェクト内の既存のエラーに気を取られることなく、担当するエラーを見つけて修正できます。また、特に多くの Explore を含む LookML プロジェクトの場合、検証を高速化できます。
バリデータの結果で、Content Validator は、検証対象のブランチまたはコミットでコンパイルされた SQL に変更がなかったためにスキップされた各 Explore を示します。増分検証の結果の例については、増分検証の結果を表示するをご覧ください。
継続的インテグレーション スイートを作成または編集するときに、[Content Validator] セクションで [増分エラーのみ] チェックボックスをオンにすると、Content Validator の増分検証を有効にできます。
増分検証については、次の点に注意してください。
- （本番環境ブランチでの手動実行などで）Content Validator が本番環境ブランチ自体を検証する場合、増分検証の設定は適用されません。本番環境ブランチを検証するときは、Content Validator に完全な検証結果が表示されます。
コンテンツ検証の制限事項
モデルを削除するか、名前を変更した場合、Content Validator はこれらの「ぶら下がり」コンテンツ エラーを返しません。これは、モデルをテスト対象のプロジェクトに関連付けることができなくなるためです。