SuperAPI AI 工具集

lookml-model

通用与其它

查看项目

更新于 10-16 00:01

技能介绍

用途:在需要创建或修改 LookML 模型文件(.model.lkml)时使用,包括定义连接、include 与模型级配置。模型文件通常对应单一数据库连接,并包含 Explore。

主要能力与必要参数:connection 必须与 Looker Admin 中定义的连接名一致;include 用于指定模型可用的 view 与 dashboard 文件。

最佳实践:尽量避免 include: ".view",以防性能问题与命名空间混乱,改用具体路径或通配符,如 include: "/views/users.view" 或 include: "/views/marketing/.view";用 label 提供界面友好名称;业务需要时设置 week_start_day(如 monday)。

缓存:应始终使用 datagroup 管理缓存策略,以对齐 ETL/ELT 流程。datagroup 在模型文件中定义,sql_trigger 返回单值(如最大时间戳),值变化即失效缓存;max_cache_age 为兜底时长;persist_with 可应用于 Explore 或整个模型。相比 persist_for(固定时间、分散管理),datagroup 由 SQL 触发、集中管理,适合生产仪表板与 ETL 同步;persist_for 仅建议用于需强制按分钟刷新的实时仪表板。

include 模式:/views/.view 用于标准模块化;具体文件路径用于精确控制、避免冲突;/**/.view 递归包含全项目,除非项目很小否则避免;/dashboards/*.dashboard 用于导入仪表板。

限制:资料未提供该技能的安装方式、平台支持范围与收费信息。