本文详解如何使用 looker python sdk 安全、可靠地获取查询的原始 sql（即 result_format="sql"），重点解决因工作区（workspace）或 git 分支配置不匹配导致的 run_query() 或 run_look() 调用失败问题。
在 Looker SDK 中，通过设置 result_format="sql" 可直接获取某 Explore 查询或 Look 对应的已解析、可执行的原始 SQL（非 LookML，而是数据库层实际运行的 SQL）。这是调试、审计、迁移或集成下游系统（如数据仓库 ETL）的关键能力。但实践中，许多开发者调用 sdk.run_query(..., result_format="sql") 或 sdk.run_look(..., result_format="sql") 时遭遇静默失败或 Exception: Error running query XXX —— 根本原因往往并非权限或语法错误，而是 SDK 会话的工作区（workspace）与目标内容所在环境不一致。
Looker 平台严格区分 production 和 dev 工作区：所有开发中的 Look、Explore 查询、仪表板默认仅存在于 dev 环境；而 SDK 初始化后默认连接 production 工作区。若强行在 production 下请求一个仅存在于 dev 的查询 ID，API 将返回 404 或 400 错误，Python SDK 捕获后抛出通用异常，掩盖了真实原因。
✅ 正确做法是：显式切换 SDK 会话至目标工作区。以下为完整流程：
1. 切换至 dev 工作区（最常见场景）
from looker_sdk import models, methods
# 假设 sdk 已正确初始化（credentials、base_url 等已配置）
sdk.update_session(
body=models.WriteApiSession(workspace_id="dev")
)执行此操作后，后续所有 run_query()、run_look() 等 API 调用均作用于 dev 环境，可成功访问开发中的资源。
在 OpenClaw 中管理 GitHub 仓库、Pull Request、Issue 与工作流。适用于审查 PR、管理 Issue、自动化 GitHub Actions、同步仓库等场景。
2. 若需指定 Git 分支（高级场景）
当项目启用了 Git 集成且需基于特定分支（如 feature/sql-optimization）运行查询时，还需同步切换分支：
sdk.update_git_branch(
project_id="lookerhub", # 替换为你的实际项目 ID
body=models.WriteGitBranch(name="feature/sql-optimization")
)⚠️ 注意：update_git_branch 必须在 update_session(workspace_id="dev") 之后调用，否则无效；且该分支必须已存在于对应项目中。
3. 安全执行 SQL 导出示例
try:
# 确保已在 dev 工作区（必要！）
response = sdk.run_query(
query_id=12345, # 替换为有效的 Explore 查询 ID
result_format="sql" # 关键：请求原始 SQL
)
print("Generated SQL:")
print(response) # response 是 str 类型，即纯 SQL 文本
except Exception as e:
print(f"Failed to fetch SQL: {e}")
# 建议添加日志：检查 query_id 是否存在、project_id 权限、workspace 状态⚠️ 重要注意事项
- 不要依赖 try/except 模糊捕获：原问题中 except: raise Exception(...) 掩盖了底层 HTTP 错误码（如 404 Not Found）。建议使用 except sdk.models.Error 或打印 response.status_code 进行精准诊断。
- result_format="sql" 仅对 run_query() 有效：run_look() 不支持 "sql" 格式，仅支持 "csv"、"json" 等结果格式；若需 Look 对应的 SQL，应先通过 API 获取其关联的 query_id，再调用 run_query()。
- 权限与上下文一致性：确保服务账号拥有目标项目、探索模型（model）、视图（view）的 see_looks 和 explore 权限，且 dev 工作区已启用。
- 生产环境慎用：update_session(workspace_id="dev") 仅用于开发调试；生产脚本应始终使用 production，并通过发布流程将变更同步至生产。
掌握工作区与分支的会话管理，是解锁 Looker SDK 全功能（尤其是元数据与 SQL 提取能力）的基础。一次正确的 update_session() 调用，往往就是从“报错”到“输出完美 SQL”的分水岭。
