用途:该技能整理 Looker CLI(looker-cli)的标准操作,覆盖配置档案、会话管理、命令发现与 API 负载工具,便于通过命令行管理多个 Looker 实例。
主要能力与用法:
配置档案:用 profile add 保存不同实例(开发、预发、生产)的连接信息到 ~/.config/looker-cli/config.yaml,支持 --host、--port,以及 --client-id、--client-secret、--token、--refresh-token。用 profile ls 列出档案(星号标记默认),profile use 切换默认档案,profile rm 删除。单次命令可用全局 --profile 覆盖,如 looker-cli user me --profile prod。
持久登录:session login 使用当前档案凭据登录并持久化会话;--oauth 走 OAuth 2.0 PKCE 浏览器登录;--text 将访问令牌输出到 stdout 而不写入配置。session get 查看当前会话(用户 ID、工作区、过期时间);session update --workspace-id 在 dev 与 production 间切换上下文;session logout 结束会话。
命令发现:meta tree 展示命令树,--noun 按资源过滤,--output json 输出 JSON;meta search <KEYWORD> 按关键词搜索高层命令与底层 API 操作。
API 负载工具:looker-cli api <group> <endpoint> 调用底层 REST 端点;--describe-body 输出请求体 JSON Schema(含类型、只写标记、可选值),--template 输出可写字段的 JSON 骨架。可重定向为文件后编辑,再用 --body 提交,如 looker-cli api project create_project --template > new_project.json 后执行 looker-cli api project create_project --body new_project.json。
限制:资料未提供版本要求、支持平台、错误处理与速率限制等信息;实际行为以所用 looker-cli 版本为准。