SuperAPI AI 工具集

creating-lookml-model

数据与分析

查看项目

更新于 10-16 00:01

技能介绍

用途:这是 Looker 开发者入职流程的第 6 步,用于编写仪表盘所需的全部 LookML(视图文件与模型文件)、在 Looker 中配置连接映射、校验 LookML 代码并运行内联查询验证功能是否正常。

前置条件:需已安装并认证 Looker CLI(第 2、3 步),并已创建 Looker 项目与 BigQuery 连接(第 4、5 步)。必须阅读并严格遵守 lookml-modeling-guidelines 技能中的最佳实践、命名要求与约束。

主要流程:1)从第 1 步 Discovery 访谈中回顾目标仪表盘、GCP 项目/数据集/表、指标与维度,不得臆造;2)按每张 BigQuery 表编写视图文件并上传,命令如 looker-cli project directory create {project_id} views 和 looker-cli project file create {project_id} views/{table_name}.view.lkml /tmp/{table_name}.view.lkml;3)编写模型文件(定义 explores、joins、includes,指定 connection),上传至项目根目录,仪表盘需 include: "/dashboards/**/*.dashboard.lookml";4)将模型配置写入 /tmp/model_config.json 并用 looker-cli model import /tmp/model_config.json 注册映射,再用 looker-cli model cat {model_name} 验证;5)用 looker-cli api project validate_project {project_id} 校验,出错则修改本地文件后重新上传验证;6)写查询负载到 /tmp/verify_query.json,执行 looker-cli query runquery --file /tmp/verify_query.json --format json 确认返回数据正常。

限制:实行零错误策略,禁止提交未通过校验的代码;include 避免使用 "/views/**/*.view.lkml" 等宽泛通配符,以防性能膨胀与编译错误。