用途:对 LookML 文件或整个项目做代码审计,检查其是否符合捆绑的最佳实践参考与风格指南,全部操作通过 Looker CLI(looker-cli)完成。
主要能力:审查字段定义、主键外键、命名规范、描述、count 度量过滤条件以及对话式分析就绪度;全项目模式还会整体分析 model-explore 关系、view 连接、datagroup 等。报告包含摘要、优点列表和按文件组织的改进点,每条给出具体修复前后的代码片段,并附带精确文件路径与行号,可用实例 URL 拼出 Looker IDE 直达链接。
使用方式:先验证环境,运行 looker-cli --help 确认已安装;运行 looker-cli user me 确认已认证,未认证时按文档配置 profile 并登录(支持 OAuth 或 API 密钥)。随后需提供 Looker 实例 URL、项目名、目标分支,以及审查整个项目还是某个文件;未提供实例 URL、项目名或分支名时必须先询问用户。之后执行 looker-cli session update dev、looker-cli project branch <project_id> --all 检查分支,再 looker-cli project checkout <project_id> <branch_name> 检出,list 与 cat 读取文件内容后分析。
限制:不得创建分支;master/main 可自动等价映射并告知用户;分支不存在、检出因未提交更改冲突、文件不存在时须立即停止并让用户澄清或处理。报告直接打印在对话或控制台,不保存为文件或 artifact。