LookML を検証する

LookML を編集すると、Looker IDE は単一のファイル内の未解決の構文エラーについて警告します(Looker IDE の概要のドキュメント ページをご覧ください)。

完全なモデル検証を行うには、LookML バリデータを使用します。結合の欠落による無効なフィールド参照などの一部のエラーは、モデルの全体像の確認を必要とし、LookML バリデータが実行されているときにのみ表示されます。変更後の LookML を本番環境に公開する前に、必ず LookML を検証する必要があります。検証であらゆる問題(データベース権限の問題など)が見つかるわけではありませんが、大半のエラーは防ぐことができます。

LookML バリデータは、前回の LookML 検証以降に更新された LookML ファイル、または更新の影響を受けるファイルのみをスキャンします。

  • モデルレベルの設定が変更された場合は、すべての項目が再度検証されます。
  • ビューが変更されると、変更されたビューが使用されている Explore のみが再度検証されます。
  • Explore が変更された場合は、変更された Explore のみが再検証されます。

検証の実行

LookML バリデータを実行するには、Looker IDE の右上にある [LookML の検証] ボタンを選択します。または、IDE の上部にある [プロジェクトの健全性] アイコンを選択して [プロジェクトの健全性] パネルを開き、[LookML の検証] アイコンをクリックします。

LookML バリデータを実行すると、対処が必要なエラーやその他の警告のリストが表示される場合があります。矢印を選択すると、エラーまたは警告のリストが開きます。

別の変更を行って保存すると、[プロジェクトの健全性] パネルのバリデータ ボタンが再び使用できるようになります。

確認メッセージ

Looker は、LookML で検証を実行した後、確認メッセージを表示します。

LookMLエラーは見つかりませんでした

バリデータで問題が検出されない場合、Looker では「LookML エラーは見つかりませんでした」というテキストとともに緑色のチェックマークが表示されます。

LookMLのエラー

LookML のエラーは、クエリの実行を妨げている可能性がある問題です。かっこ内の数字は、検出されたエラーの数です(次の例では 9 個)。

LookML Errors(9)というテキストを含む検証メッセージの例。

展開された問題のリストには、検証に合格しなかった理由が表示されます。多くの場合、エラーをクリックすると、問題のあるコード行に直接移動します。行の横には赤い「X」が表示されます。カーソルを合わせると、さらに詳細なエラー情報が表示される場合があります。

値が指定されていないタイプ パラメータの定義にカーソルを合わせると表示されるエラーの例。エラーテキストには、type に値を指定する必要があることを示しています。

チャットチームに関するヒント: 最も頻繁にお問い合わせいただく検証エラーは「不明またはアクセス不可のフィールド」です。原因と対処方法については、エラー: 不明またはアクセス不可のフィールドのベスト プラクティスのページをご覧ください。

LookMLの警告

LookML の警告はクエリの実行を妨げない場合もありますが、ユーザーが利用する機能が破損している、または意図しない状態になる可能性があります。エラーの場合と同様に、かっこ内の数字は、検出された警告の数です(次の例では 3 つの警告)。

LookML 警告(3)というテキストを含む検証メッセージの例。

LookML エラーと同様に、[プロジェクトの健全性] パネルで警告を選択し、赤色の X アイコンにカーソルを合わせると、警告を展開してエラーコードに移動し詳細情報を表示できます。

Explore がビュー名と一致する必要がある、または Explore が from または view_name プロパティを持つ必要があるというテキストを含む警告の例。

変更をデプロイする

変更が正しく機能することを確認したら、Looker の Git 統合を使用して、変更を commit して本番環境にデプロイすることができます。