2026年11月20日

【Looker】VS Code で LookML のバリデーションを実行してみた


Content

こんにちは!suです。

Looker の LookML のバリデーションを、VS Code から実行できることをご存じですか?
2026 年 9 月に GA(一般提供)になった VS Code 用の Looker 拡張機能を使うと、ファイルを保存するだけでバリデータが走ります。

私は Looker の案件に入ったばかりのころ、先輩から、こんな話を聞きました。
Git 経由で commit すると、Looker のバリデーションを通せず、エラーを素通りさせてしまう事故が過去にあった、という話です。
そのため、これまではローカルや Claude で作った LookML を Looker の IDE にコピペして、手動でバリデータのボタンを押していました。
しかし、開発に慣れてくると、毎回のコピペが面倒になってきました。

そこで今回は、VS Code の拡張機能に OAuth でサインインして、push の前に LookML のエラーを見つけられるかを試しました。
あわせて、Git の hook でバリデーションを実行していない commit を止められるか、本番のブランチ(master)で編集するとどうなるかを確かめた結果を紹介します。

先に結論

  • VS Code から、LookML のエラーを検出できました。
    保存すると、自動でバリデーションが走ります。
  • VS Code からの commit と push は、エラーのままでも止まりませんでした。
  • git hook を使うと、バリデーションを実行していない commit を止められました。
    ただし、公式の方法ではなく、--no-verify で抜けられます。
  • 本番のブランチ(master)で編集すると、Looker に送られず、エラーがあってもバリデーションが通りました。

※試した環境は、Looker のバージョン 26.22.2、拡張機能 1.0.0、Windows です。

拡張機能を入れて OAuth でサインインする

VS Code から LookML のバリデーションを実行するには、Looker の拡張機能を入れて、サインインする必要があります。
サインインは、公式のドキュメントが推奨している OAuth を選びました。
理由は、案件によっては個人への API キーの発行が権限規約で許可されないことがあるからです。
新人でも、同じ手順を再現しやすいと考えました。

なお、この拡張機能は、2026 年 9 月 10 日に GA になりました(公式のリリースノートの記載)。
その項目には、Looker (original) のタグも付いています。

管理者と開発者の作業

流れは、次の 2 段階です。

誰が やること
管理者 拡張機能を、OAuth クライアントとして Looker に登録する。登録のときに決めた OAuth クライアントの ID(client_guid)を、開発者に伝える
開発者(自分) 拡張機能を VS Code に入れる。コマンド「Looker: Show Onboarding Walkthrough」を実行して、表示された画面で API キーではなく OAuth を選ぶ。そのあとは画面の案内に沿って進める(Looker の URL、OAuth クライアントの ID、プロジェクト ID が要る)

前提は、Looker のバージョンが 26.6 以降であることと、編集するモデルへの develop 権限です。

拡張機能を探して入れる

拡張機能は VS Code の拡張機能の検索で「Looker」と入れて探します。
似た名前の拡張機能が多く並ぶので、発行元が Google で、認証マークのある「Looker by Google Cloud」を選びます。
詳しい手順は、公式のドキュメントのとおりに進めました。
この記事では、細かい画面の手順は書きません。

参考:

VS Code で LookML のバリデーションを実行する

コマンドは LookML のファイルを開くと出る

バリデーションはコマンドパレットの「Looker: Validate LookML」で実行します。
ただ、このコマンドは、LookML のファイルをエディタで開いているときだけ出ます。
ファイルを開かずに「Looker」と検索すると、見当たらないので、注意してください。

保存するとバリデーションが走る

VS Code のエディタでファイルを保存すると、バリデーションが自動で走ります。
コマンドを実行する必要はありません。
エラーがあると、該当の行に赤い波線が出ます。

例として、join に、存在しない view を指定してみました。

VS Code のエディタで、存在しない view を指定した join の行と、それを使う行に赤い波線が出ている

ただ、波線がないだけでは成功とは言い切れません(あとの章の master の例を参照)。
確実に知りたいときは、コマンドでバリデーションを実行します。

同じ例の結果は、出力パネルの「Looker」のチャンネルにも出ます。
エラーの件数、文言、ファイルと行番号が並びます。

VS Code の出力パネルに、バリデーションが 3 件のエラーで失敗したことと、各エラーの文言と行番号が並んでいる

どんなエラーを検出できたか

ダミーの LookML に、エラーを 1 つずつ入れて、検出できるかを試しました。

入れたエラー 件数 1 件目のメッセージ
括弧(})を 1 つ消す 3 Invalid lookml syntax near line 14
存在しないフィールドを、measure で参照する 2 Unknown or inaccessible field "…no_such_field" referenced in "…broken_total"
join に、存在しない view を指定する 3 Unknown view 'demo_missing_view' --> Did you '- include: demo_missing_view' in …?
同じ名前のディメンションを 2 つ書く 2 Redefinition of field 'demo_customers.region'
include に、存在しないファイルを指定する 2 LookML file "/blog_test/no_such_file.view.lkml" not found

今回の環境では、5 種類とも検出できました。

件数は原因の数ではない

表のとおり、原因は 1 つでも、エラーは複数件出ます。
括弧を 1 つ消した例では、3 件出ました。
ビューの構文エラーが 1 件と、そのビューを使うモデルのファイルに 2 件です。
括弧を戻すと、3 件とも消えました。
別のファイルに出たエラーは、連鎖の結果かもしれません。
いちばん上のエラーから直すとよさそうです。

メッセージのヒントも鵜呑みにしないほうがよいです。
存在しない view を指定した例では、include の書き忘れを尋ねるヒントが付きました。
ただ、実際の原因は存在しない view を指定したことでした。
ヒントだけで決めず、文言の全体とほかのエラーもあわせて見ます。

Looker の IDE と比べる

同じエラー(存在しない view を指定した例)を、Looker の IDE のバリデータでも確認しました。

Looker の IDE の「LookML の検証」パネルに、VS Code の出力パネルと同じ 3 件のエラーが表示されている

件数(3 件)、文言、行番号(6、6、9)、順番が、VS Code の出力パネルと一致しました。

エラーのまま commit と push ができた

Looker の IDE の commit は設定で止められる

Looker の IDE には、commit の前にバリデーションを求めるかを決める「Code Quality」という設定があります。
プロジェクトの設定の画面にあり、選択肢は 3 つです。

選択肢 内容
commit 前にエラーと警告を修正する必要がある エラーと警告を直さないと commit できない。公式の推奨
commit 前に必要なのはエラーの修正のみ 警告が残っていても commit できる
破損したコードの commit を許可(非推奨) バリデーションを実行せず、エラーや警告があっても commit できる

この設定を変えられるのは、Looker の管理者だけです。

私の環境の新しいプロジェクトは、1 つ目が選ばれていました。
エラーのある状態で IDE の「commit」を押すと先にバリデーションが走り、エラーが表示されました。
commit の入力画面には進めませんでした。
3 つ目に変えて同じ状態で「commit」を押すと、バリデーションは走らず入力画面に進めました。

VS Code からは止まらなかった

では、VS Code から commit と push をするとどうなるでしょうか。
1 つ目の設定のまま、開発用のブランチ(Looker の開発モードで使う、自分用のブランチ)で試しました。

存在しないフィールドを参照する measure を足して保存すると、バリデーションが自動で走り、エラーが 2 件出ました。
この状態でソース管理の「コミット」ボタンを押すと、commit できました。
そのまま push もできました。
警告や確認の画面は出ませんでした。

保存した時点でファイルは Looker にも送られています。
Looker の IDE で見ると、送った内容がそのまま見えます。
バリデーションを実行すると、VS Code と同じ 2 件のエラーが出ました。

Looker の IDE の画面に、VS Code から push したエラーのある measure の行と、右のパネルの「LookML のエラー (2)」が表示されている

Code Quality の設定は、IDE の commit にだけ効いているようです。
ローカルの Git からの commit と push について、バリデーションの扱いを説明する記載は、私が読んだ範囲の公式ドキュメントには、見当たりませんでした。
エラーのまま commit と push ができる形は、私の環境で再現できました。

参考:

バリデーションを実行していない commit を hook で止める

前の章のとおり、VS Code からの commit は、バリデーションを実行していなくても止まりません。
そこで、Git の hook で止められるかを試しました。

hook は commit の前に動くスクリプト

hook は Git の操作の前後に自動で動くスクリプトです。
commit の前に動くものを「pre-commit」といい、リポジトリの .git/hooks/pre-commit に置きます。
スクリプトがエラーの終了コードで終わると、commit は取り消されます。

VS Code のソース管理の「コミット」ボタンでも、hook は動きました。
止まったときは、スクリプトが出したメッセージが、ダイアログにそのまま出ました。

次の画面は、エラーがある状態で「コミット」を押したときのものです。

エラーのある measure に赤い波線が出ているエディタの上で、最後のバリデーションにエラーがあったとして hook が commit を止めたことを示すダイアログが出ている

拡張機能のログからバリデーションの結果を読む

拡張機能はバリデーションの結果を VS Code のログに残します。
hook はそのログから最後のバリデーションの結果を読んで、次のように判断します。

最後のバリデーションの状態 hook の判断 出たメッセージ
エラーがある 止める The last validation had errors. Fix them, validate, then retry.
バリデーションが最後の保存より古い 止める No validation after the last save. Run 'Looker: Validate LookML', then retry.
結果が見当たらない 止める No result for the last validation. Run 'Looker: Validate LookML', then retry.
成功した 通す なし

今回の環境で試した結果は、次のとおりです。

  • 最後のバリデーションでエラーが出ているときは、commit が止まりました(保存の自動バリデーションでも、手動のバリデーションでも)
  • エラーがなくても、手動のバリデーションを実行していないと、止まりました
  • 手動のバリデーションで成功したあとは、commit が通りました

エラーがないのに止まるのは、保存の自動バリデーションが、エラーのないときは結果をログに残さないようだからです。
結果が見当たらないので、hook は手動のバリデーションを求めます。

AI に任せる場合

Claude Code などの AI に LookML を書かせる場合は、プロジェクトの CLAUDE.md にバリデーションのルールを書く方法も試しました。
書いた内容の要点は、次のとおりです。

# LookML の作業ルール

- バリデーションは、VS Code のコマンド「Looker: Validate LookML」で行う。Claude は実行できない
- `.lkml` を編集したら、commit の前に、ユーザーにバリデーションを頼む
- `--no-verify` や、hook の無効化はしない
- push はしない
- master では編集しない

新しいセッションで「バリデーションは後でやるので先に commit して」と頼んだところ、AI は断りました。
理由は「このルールは、エラーを素通りさせる事故を防ぐためのものなので、私の判断では外しません」という趣旨でした。

ただ、ルールは案内で、強制ではありません。
バリデーションを実行していないのに「成功しました」と伝えたところ、AI は commit を試みました。
止めたのは hook です。
AI は --no-verify を使わず、バリデーションのやり直しを頼んできました。

さらに安全性を高めたい場合は、AI がバリデーションを自分で実行して結果を読める仕組み(自作の VS Code 拡張機能など)を作る手もありそうです。
ただし、公式の方法ではありません。

VS Code では master を触れてしまう

Looker の IDE で本番のブランチ(master)を見るには、開発モードをオフにして本番モードにします。
本番モードは「読み取り専用」と表示され、編集できません。
バリデータと Git のアクションも、使えません。

一方、VS Code ではブランチを自分で切り替えるので、master を開いて編集できてしまいます。
では、VS Code で master を触ると、どうなるでしょうか。
Git につないだプロジェクトの clone で試しました。

master で編集するとバリデーションが通ってしまう

master で、エラーのある LookML を書いて、保存したあとにバリデーションを実行しました。
存在しないフィールドを参照する measure と、join に存在しない view を指定したものの、2 種類を試しました。

ローカルのブランチ 保存したときのログ バリデーションの結果
開発用のブランチ ファイルを Looker に送った記録(Updating file)がある エラーを検出(measure の例で 2 件)
master 「Syncing to Looker is disabled on production branch.」と出る。ファイルの送信の記録は、なし どちらも検出されず、「LookML Validated Successfully!」と出た

次の画面は、measure の例を master で実行したときのものです。
波線は出ず、出力パネルに「LookML Validated Successfully!」と出ています。

master のブランチでエラーのある measure を保存してバリデーションを実行したが、波線は出ず、出力パネルに同期が無効という文言と「LookML Validated Successfully!」が出ている

master は Looker 側が読み取り専用なので、拡張機能もローカルの編集を Looker に送らないのかもしれません。
バリデーションは Looker 側の元の内容に対して走っているようです。
そのため、ローカルに間違いがあっても、バリデーションは成功と出ました。
拡張機能がファイルを送らない挙動の説明は、私が読んだ範囲の公式ドキュメントには、見当たりませんでした。

うっかり commit を防ぐ

VS Code では、ブランチの切り替えを忘れて、master のまま作業してしまうことがあります。

VS Code の標準の設定 git.branchProtection に master を入れると、master に commit しようとしたときに、確認が出ます。

VS Code のダイアログが、保護されたブランチに commit しようとしていると警告し、「このままコミット」などの選択肢を出している

ただ、「このままコミット」の選択肢を選ぶと、commit の処理に進みます。
止める仕組みではなく、気づかせる仕組みのようです。

そこで、pre-commit hook に、今のブランチが master なら止める処理を足しました。
確認のダイアログで「このままコミット」を押しても、hook が止めました。

VS Code のダイアログが、hook が master のブランチへの commit を止めたと表示している

commit を止めても push はできる

新しい commit を作らなくても、すでにある commit は、git push origin HEAD:master のような形で master に push できます。
pre-commit hook では、防げません。

そこで、pre-push hook も足しました。
送り先が master なら止める hook です。
開発用のブランチで git push --dry-run origin HEAD:master を実行すると、hook が呼ばれて止めました。
--dry-run でも、pre-push hook は動きました。

hook が止めるのは、commit と push のときです。
編集と保存は止まりません。

hook を抜けて push するとどうなるか

--no-verify を付けると、commit も push も、通りました。
hook はうっかりを防ぐ仕組みで、意図して抜けることはできます。

エラーのある LookML を commit して、GitHub の master に push したあと、Looker の本番モードのファイルを見ると、変わっていませんでした。
今回の環境では、Looker の本番には、自動では反映されないようです。

ただ、GitHub の master には、エラーのある LookML を含む commit が残ります。
開発用のブランチで git pull origin master を実行すると、そのエラーが、そのまま入りました。
エラーに気づくには、pull のあとに、「Looker: Validate LookML」を実行します。

まとめ

今回試した範囲では、次の流れで作業するのがよさそうです。

1. 準備(最初の 1 回)

管理者が拡張機能を OAuth クライアントとして Looker に登録します。
自分は拡張機能を入れて、サインインします。

管理者に頼む作業と自分の作業が分かれます。

↓
2. 作業の前

今のブランチが開発用のブランチかを確認します。

master では Looker に送られず、エラーがあってもバリデーションが通ります。

↓
3. 編集と保存

LookML を書いて保存します。

保存すると自動でバリデーションが走ります。
波線がなくても、成功とは限りません。
確実に知りたいときは、「Looker: Validate LookML」を実行します。

↓
4. エラーの修正

いちばん上のエラーから直します。

件数は原因の数ではありません。
ヒントは鵜呑みにしないほうがよいです。

↓
5. 動作確認

Looker の IDE でダッシュボードの動作確認をします。

保存した内容は commit しなくても、開発モードの IDE に見えます。
開いたままの画面は、リロードします。

↓
6. commit と push の前

バリデーションの結果を自分の目で見ます。

VS Code の commit と push はエラーがあっても止まりません。
忘れそうなときは hook で止められます。
ただし、--no-verify で抜けられます。

システムサポートでは、Google Cloudの導入や活用を支援しております。

Google Cloudを導入したい・導入したけど使いこなせていない…という方は、お気軽にご相談ください!

Google Cloud 導入・活動支援に関するご相談はこちら

2026年11月20日 【Looker】VS Code で LookML のバリデーションを実行してみた

Category Google Cloud

ご意見・ご相談・料金のお見積もりなど、
お気軽にお問い合わせください。

お問い合わせはこちら