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 個)。
展開された問題のリストには、検証に合格しなかった理由が表示されます。多くの場合、エラーをクリックすると、問題のあるコード行に直接移動します。行の横には赤い「X」が表示されます。カーソルを合わせると、さらに詳細なエラー情報が表示される場合があります。
チャットチームに関するヒント: 最も頻繁にお問い合わせいただく検証エラーは「不明またはアクセス不可のフィールド」です。原因と対処方法については、エラー: 不明またはアクセス不可のフィールドのベスト プラクティスのページをご覧ください。
LookMLの警告
LookML の警告はクエリの実行を妨げない場合もありますが、ユーザーが利用する機能が破損している、または意図しない状態になる可能性があります。エラーの場合と同様に、かっこ内の数字は、検出された警告の数です(次の例では 3 つの警告)。
LookML エラーと同様に、[プロジェクトの健全性] パネルで警告を選択し、赤色の X アイコンにカーソルを合わせると、警告を展開してエラーコードに移動し詳細情報を表示できます。
変更をデプロイする
変更が正しく機能することを確認したら、Looker の Git 統合を使用して、変更を commit して本番環境にデプロイすることができます。