用途:这是 Looker 开发者入门流程的最终步骤,用于在项目中定义目标 LookML 仪表板文件,将其导入 Looker 成为用户自定义仪表板(UDD),并依据用户反馈反复更新与同步。
前置条件:需已安装并认证 Looker CLI;Looker 项目、连接、视图与模型已完成设置并通过验证。
主要步骤:
- 回顾此前与用户确认的仪表板目标、表、维度和度量;用 looker-cli folder ls 找到 Shared 文件夹 ID(新实例中通常为 1)。
- 创建仪表板目录 looker-cli project directory create {project_id} dashboards,编写 .dashboard.lookml 文件并上传:looker-cli project file create {project_id} dashboards/{dashboard_name}.dashboard.lookml /tmp/{dashboard_name}.dashboard.lookml。必须在模型文件中 include: "/dashboards/**/*.dashboard.lookml"。建议使用 layout: newspaper,避免旧 grid 布局导致的导入错误。
- 用 looker-cli api project validate_project {project_id} 校验,出错则修正后重试。
- 以 {model_name}::{dashboard_name} 形式构造 lookml_dashboard_id,切换开发工作区后导入:looker-cli session update dev && looker-cli dashboard import lookml {model_name}::{dashboard_name} {folder_id},记录返回的数字 id 或 slug。
- 取仪表板元素 query_id:looker-cli dashboard cat {udd_id} --fields "dashboard_elements(query_id)",对每个非空 query_id 执行 looker-cli query runquery {query_id} 验证 SQL;失败需修复视图、提交、重新校验并同步后重复验证。
- 将 {instance_url}/dashboards/{udd_id} 链接交给用户并停下来征求反馈。
- 如需修改,用 looker-cli project file update 更新文件、重新校验,再用 looker-cli dashboard sync lookml {model_name}::{dashboard_name} 同步,并重新执行查询验证,循环直至用户满意。
限制:项目校验只检查 LookML 语法,不等于 SQL 可执行,因此必须逐块验证查询。