Lookerctl

🚀 lookerctl

lookerctlは、LookMLを大規模で管理および最適化するための包括的なCLIツールです。このツールを使用することで、LookMLの開発や運用を効率的に行うことができます。

🚀 クイックスタート

# 1. 環境のセットアップ
source .env

# 2. 接続のテスト
lookerctl test

# 3. LookMLのエクスポート
lookerctl export all --output-dir ./lookml

# 4. 静的解析と検証の実行 (高速!)
lookerctl validate static ./lookml

# 5. 使用状況の分析
lookerctl analyze usage

✨ 主な機能

• ⚡ 検証速度が66倍向上 - 大規模なLookerインスタンスでは、APIを使用した場合の40秒に対して、ローカルでの検証が600msで完了します。
• 🔄 完全なローカル開発サポート - エクスポート → 編集 → 検証 → プッシュの一連のワークフローをサポートします。
• 📊 使用状況分析 - ユーザーが実際に使用しているフィールドを把握できます。
• 🧪 科学的なテスト - Lookerの組み込みデータテストを補完する、A/Bテストやゴールデンテストを提供します。
• 🔍 依存関係マッピング - 変更を行う前に影響を把握できます。
• 🤖 AI対応 - すべての出力がJSON形式で、AIによる消費に適しています。
• 🔌 MCPサーバー - モデルコンテキストプロトコルを介して、AIエージェント用の20のツールを提供します。

📦 インストール

# 1. 依存関係のインストール
uv pip install -r requirements.txt

# 2. 認証情報の設定 (.envファイル)
export LOOKERSDK_BASE_URL=https://your-instance.looker.com:443
export LOOKERSDK_CLIENT_ID=your_client_id
export LOOKERSDK_CLIENT_SECRET=your_client_secret

# 3. 接続のテスト
lookerctl test

💻 使用例

基本的な使用法

# ローカル開発のワークフロー
# ローカルのgitブランチと同期
lookerctl session sync my-project

# ローカルにエクスポート
lookerctl export project my-project -o ./local

# 変更を加える
vim ./local/views/users.view.lkml

# 検証 (600ms!)
lookerctl validate static ./local

# Lookerにプッシュ
lookerctl export push my-project ./local

高度な使用法

# A/Bテストの最適化
# 変更前にベースラインを作成
lookerctl query-test baseline create model.explore \
  -q query.json -o before.json

# 最適化の変更を行う
# ... SQLの最適化、インデックスの追加 ...

# 変更後の比較
lookerctl query-test baseline compare model.explore \
  -b before.json

# 結果: ✓ データに変更がなく、39%高速化！

# 使用状況の分析
# 使用されているものを分析
lookerctl analyze usage -o usage.json

# 未使用のexploreを検索
lookerctl analyze unused

# 依存関係グラフを構築
lookerctl deps build ./lookml -o deps.json

# AIエージェント用のMCPサーバー
# MCPサーバーを起動 (Claude Desktop用)
lookerctl mcp

# Claude Desktopの設定に追加
# {
#   "mcpServers": {
#     "looker": {
#       "command": "/path/tlookerctl",
#       "args": ["mcp"],
#       "env": { ... }
#     }
#   }
# }

# 次にClaudeに問い合わせる
# "すべてのLookerプロジェクトをリストする"
# "未使用のexploreを検索する"
# "./lookmlの依存関係を分析する"

📚 ドキュメント

始める前に

• 入門ガイド - インストールとセットアップ
• コアコンセプト - ツールの理解

リファレンス

• CLIリファレンス - 完全なコマンドリファレンス
• クエリテスト - ベースラインとA/Bテスト
• ローカル検証 - 高速なローカル検証
• AI統合 - AI駆動のワークフロー
• MCPサーバー - AIエージェント用のモデルコンテキストプロトコルの統合

サンプル

• サンプルディレクトリ - 実際に動作するサンプルとテンプレート

パフォーマンス

主要コマンド

# セッション管理
lookerctl session sync
lookerctl session workspace dev

# エクスポート/プッシュ
lookerctl export all -o ./lookml
lookerctl export push my-project ./lookml

# 検証
lookerctl validate static ./lookml     # 600ms
lookerctl validate local my-project ./lookml   # 40秒、高精度

# 分析
lookerctl analyze usage
lookerctl deps build ./lookml

# テスト
lookerctl query-test baseline create model.explore -q query.json
lookerctl query-test baseline compare model.explore -b baseline.json
lookerctl query-test golden run

使用事例

開発者向け

• Lookerコンソールのようなローカル開発ワークフロー
• 反復開発中の高速な検証
• ベースラインを使用した安全なリファクタリング
• 変更前の影響分析

AIシステム向け

• AIエージェント用の20のツールを備えたMCPサーバー
• 分析用のすべてのLookMLのエクスポート
• プログラムによるフィールドの探索
• 検証を伴う自動化された最適化
• 改善点の科学的なテスト

チーム向け

• ユーザーが作成したコンテンツの可視化
• ゴールデンテストを用いたCI/CDの統合
• 時間経過に伴うパフォーマンスの追跡
• 自動化された最適化パイプライン

サポート

• 📖 ドキュメント：docs/ を参照してください。
• 🐛 問題報告：チームの問題追跡システムを通じて報告してください。
• ❓ ヘルプ：入門ガイド から始めてください。

ステータス

✅ 本番環境での使用可

• すべての機能がエンドツーエンドでテストされています。
• 完全なA/Bテストワークフローが検証されています。
• ローカル検証が66倍高速化されています。
• 包括的なドキュメントが用意されています。
• 完全なエラーハンドリングが実装されています。

バージョン: 0.1.0 最終更新日: 2025-10-11

完全なドキュメントはこちら: docs/README.md