用途:在需要创建或修改 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 用于导入仪表板。
限制:资料未提供该技能的安装方式、平台支持范围与收费信息。