SuperAPI AI 工具集

creating-looker-dashboard

数据与分析

查看项目

更新于 10-16 00:01

技能介绍

用途:这是 Looker 开发者入门流程的最终步骤,用于在项目中定义目标 LookML 仪表板文件,将其导入 Looker 成为用户自定义仪表板(UDD),并依据用户反馈反复更新与同步。

前置条件:需已安装并认证 Looker CLI;Looker 项目、连接、视图与模型已完成设置并通过验证。

主要步骤:

  1. 回顾此前与用户确认的仪表板目标、表、维度和度量;用 looker-cli folder ls 找到 Shared 文件夹 ID(新实例中通常为 1)。
  2. 创建仪表板目录 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 布局导致的导入错误。
  3. 用 looker-cli api project validate_project {project_id} 校验,出错则修正后重试。
  4. 以 {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。
  5. 取仪表板元素 query_id:looker-cli dashboard cat {udd_id} --fields "dashboard_elements(query_id)",对每个非空 query_id 执行 looker-cli query runquery {query_id} 验证 SQL;失败需修复视图、提交、重新校验并同步后重复验证。
  6. 将 {instance_url}/dashboards/{udd_id} 链接交给用户并停下来征求反馈。
  7. 如需修改,用 looker-cli project file update 更新文件、重新校验,再用 looker-cli dashboard sync lookml {model_name}::{dashboard_name} 同步,并重新执行查询验证,循环直至用户满意。

限制:项目校验只检查 LookML 语法,不等于 SQL 可执行,因此必须逐块验证查询。