2026年11月20日 【Looker】VS Code で LookML のバリデーションを実行してみた Google Cloud Looker 検索する Popular tags 事例紹介 GEN-STEP 生成AI(Generative AI) PTE(Partner Top Engineer) Vertex AI Search Looker Studio BigQuery AlloyDB Google Workspace Cloud SQL Claude Category Google Cloud Author su SHARE 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 のバリデーションを実行する ↓エラーのまま commit と push ができた ↓バリデーションを実行していない commit を hook で止める ↓VS Code では master を触れてしまう ↓まとめ 拡張機能を入れて 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」を選びます。 詳しい手順は、公式のドキュメントのとおりに進めました。 この記事では、細かい画面の手順は書きません。 参考: Looker のリリースノート(公式) Getting started with the Looker VS Code extension(公式) VS Code で LookML のバリデーションを実行する コマンドは LookML のファイルを開くと出る バリデーションはコマンドパレットの「Looker: Validate LookML」で実行します。 ただ、このコマンドは、LookML のファイルをエディタで開いているときだけ出ます。 ファイルを開かずに「Looker」と検索すると、見当たらないので、注意してください。 保存するとバリデーションが走る VS Code のエディタでファイルを保存すると、バリデーションが自動で走ります。 コマンドを実行する必要はありません。 エラーがあると、該当の行に赤い波線が出ます。 例として、join に、存在しない view を指定してみました。 ただ、波線がないだけでは成功とは言い切れません(あとの章の master の例を参照)。 確実に知りたいときは、コマンドでバリデーションを実行します。 同じ例の結果は、出力パネルの「Looker」のチャンネルにも出ます。 エラーの件数、文言、ファイルと行番号が並びます。 どんなエラーを検出できたか ダミーの 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 のバリデータでも確認しました。 件数(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 件のエラーが出ました。 Code Quality の設定は、IDE の commit にだけ効いているようです。 ローカルの Git からの commit と push について、バリデーションの扱いを説明する記載は、私が読んだ範囲の公式ドキュメントには、見当たりませんでした。 エラーのまま commit と push ができる形は、私の環境で再現できました。 参考: Git options(公式) バリデーションを実行していない commit を hook で止める 前の章のとおり、VS Code からの commit は、バリデーションを実行していなくても止まりません。 そこで、Git の hook で止められるかを試しました。 hook は commit の前に動くスクリプト hook は Git の操作の前後に自動で動くスクリプトです。 commit の前に動くものを「pre-commit」といい、リポジトリの .git/hooks/pre-commit に置きます。 スクリプトがエラーの終了コードで終わると、commit は取り消されます。 VS Code のソース管理の「コミット」ボタンでも、hook は動きました。 止まったときは、スクリプトが出したメッセージが、ダイアログにそのまま出ました。 次の画面は、エラーがある状態で「コミット」を押したときのものです。 拡張機能のログからバリデーションの結果を読む 拡張機能はバリデーションの結果を 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 は Looker 側が読み取り専用なので、拡張機能もローカルの編集を Looker に送らないのかもしれません。 バリデーションは Looker 側の元の内容に対して走っているようです。 そのため、ローカルに間違いがあっても、バリデーションは成功と出ました。 拡張機能がファイルを送らない挙動の説明は、私が読んだ範囲の公式ドキュメントには、見当たりませんでした。 うっかり commit を防ぐ VS Code では、ブランチの切り替えを忘れて、master のまま作業してしまうことがあります。 VS Code の標準の設定 git.branchProtection に master を入れると、master に commit しようとしたときに、確認が出ます。 ただ、「このままコミット」の選択肢を選ぶと、commit の処理に進みます。 止める仕組みではなく、気づかせる仕組みのようです。 そこで、pre-commit hook に、今のブランチが master なら止める処理を足しました。 確認のダイアログで「このままコミット」を押しても、hook が止めました。 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 で抜けられます。 関連コンテンツ 【Looker】Claude Design でデザインしたダッシュボードを、Claude Codeで実装してみた by suon 2026年10月29日 【Looker】ダッシュボードエージェントの回答を検証 by suon 2026年11月2日 システムサポートでは、Google Cloudの導入や活用を支援しております。 Google Cloudを導入したい・導入したけど使いこなせていない…という方は、お気軽にご相談ください! Google Cloud 導入・活動支援に関するご相談はこちら 頂きましたご意見につきましては、今後のより良い商品開発・サービス改善に活かしていきたいと考えております。 ありがとう よくわかった 興味がある 面白かった よくわからない もっと知りたい 使ってみたい Looker大好き Author su 2026年4月に新卒入社、数学科卒の新人エンジニアです。 趣味はコントラバスと編み物でものすごいインドアです。 Google Cloud Looker 2026年11月20日 【Looker】VS Code で LookML のバリデーションを実行してみた Category Google Cloud 前の記事を読む Gemini 4の3モデル(Carbon・Argon・Hydrogen)とは?Gemini 3シリーズやClaude・GPTとの違いを比べてみた Recommendation オススメ記事 2023年9月5日 Google Cloud 【Google Cloud】Looker Studio × Looker Studio Pro × Looker を徹底比較!機能・選び方を解説 2023年8月24日 Google Cloud 【Google Cloud】Migrate for Anthos and GKEでVMを移行してみた(1:概要編) 2022年10月10日 Google Cloud 【Google Cloud】AlloyDB と Cloud SQL を徹底比較してみた!!(第1回:AlloyDB の概要、性能検証編) GEN-STEP Gemini Enterprise 導入パッケージ 生成AI導入支援サービス Google Cloud 資料ダウンロード 新着記事 2026年11月20日 Google Cloud 【Looker】VS Code で LookML のバリデーションを実行してみた 2026年11月16日 Google Cloud Gemini 4の3モデル(Carbon・Argon・Hydrogen)とは?Gemini 3シリーズやClaude・GPTとの違いを比べてみた 2026年11月12日 Google Cloud 【2026年11月版】AIエージェントが権限不足で停止!? ADK × Gemini Enterprise Agent PlatformでHITLを実践してみた! HOME Google Cloud 【Looker】VS Code で LookML のバリデーションを実行してみた