Lookerctl

🚀 lookerctl

lookerctl 是一款全面的命令行工具（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 實例，本地驗證僅需 600 毫秒，而使用 API 則需 40 秒。
• 🔄 完整的本地開發流程：支持導出 → 編輯 → 驗證 → 推送的工作流程。
• 📊 使用情況分析：幫助瞭解用戶實際使用的字段。
• 🧪 科學測試：提供 AB 測試和黃金測試，增強信心，補充 Looker 內置的數據測試。
• 🔍 依賴映射：在進行更改之前瞭解影響。
• 🤖 支持 AI：所有輸出均為 JSON 格式，便於 AI 消費。
• 🔌 MCP 服務器：通過模型上下文協議為 AI 代理提供 20 種工具。

📦 安裝指南

# 1. 安裝依賴項
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

# 驗證（600 毫秒！）
lookerctl validate static ./local

# 推送到 Looker
lookerctl export push my-project ./local

高級用法

# AB 測試優化
# 在更改前創建基線
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

# 查找未使用的探索
lookerctl analyze unused

# 構建依賴圖
lookerctl deps build ./lookml -o deps.json

# 為 AI 代理啟動 MCP 服務器
# 啟動 MCP 服務器（適用於 Claude Desktop）
lookerctl mcp

# 添加到 Claude Desktop 配置：
# {
#   "mcpServers": {
#     "looker": {
#       "command": "/path/to/lookerctl",
#       "args": ["mcp"],
#       "env": { ... }
#     }
#   }
# }

# 然後向 Claude 提問：
# "列出所有 Looker 項目"
# "查找未使用的探索"
# "分析 ./lookml 中的依賴關係"

📚 詳細文檔

入門指南

• 入門指南 - 安裝和設置
• 核心概念 - 瞭解工具

參考文檔

• CLI 參考 - 完整的命令參考
• 查詢測試 - 基線和 AB 測試
• 本地驗證 - 快速的本地驗證
• 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     # 600 毫秒
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/
• 🐛 問題反饋：通過團隊的問題跟蹤器報告
• ❓ 幫助：從 入門指南 開始

狀態

✅ 可用於生產環境

• 所有功能均經過端到端測試。
• 完整的 AB 測試工作流已驗證。
• 本地驗證速度提升 66 倍。
• 提供全面的文檔。
• 完善的錯誤處理。

版本：0.1.0 最後更新：2025-10-11

完整文檔請參閱：docs/README.md