SuperAPI AI 工具集

semantic-layer-setup

数据与分析

查看项目

更新于 10-15 20:33

技能介绍

用途:在已完成的 Gold 层之上,端到端编排构建 Databricks 语义层,产出 Metric Views、表值函数(TVF)与 Genie Spaces。前置条件为 gold-layer-setup 技能,即 Gold 表必须已存在。资料给出的时间估算为初次搭建 3-4 小时,每增加一个域 1-2 小时。

主要能力:按 7 个阶段(0-6)推进,生成 Metric View YAML 定义、创建脚本、TVF SQL、Genie Space JSON 配置与部署 notebook,以及合并的 Asset Bundle 作业。产物路径示例:src/{project}_semantic/metric_views/.yaml、create_metric_views.py、table_valued_functions.sql、genie_configs/.json、deploy_genie_spaces.py、resources/semantic/semantic_layer_job.yml,并修改 databricks.yml。

使用方式:先读取 plans/manifests/semantic-layer-manifest.yaml,缺失则停止并提示先运行 planning/00-project-planning(stage 5)。随后从 Gold YAML 与 information_schema.columns 交叉提取 gold_inventory,作为唯一表/列名来源。按阶段即时加载对应 SKILL.md,逐阶段持久化“Notes to Carry Forward”并丢弃完整技能内容。

强制默认:Metric View 使用 WITH METRICS LANGUAGE YAML;TVF 参数全部为 STRING;Genie 使用 Serverless SQL Warehouse;每个 Genie Space 至少 10 个基准问题;Gold 表列注释必需。

适用场景:需要按项目计划批量构建语义层,或仅需 Metric Views、TVF、Genie Space 配置、Genie API 自动化、Genie 精度优化时,可分别直接读取对应子技能。

限制:不得创建清单之外的产物;不得凭记忆生成模式;清单缺失必须停止;Gold 表未部署时需先验证。其余细节资料未提供。