SuperAPI AI 工具集

snowflake-semanticview

通用与其它

查看项目

更新于 10-16 05:49

技能介绍

用途:帮助创建、修改和验证 Snowflake 语义视图(semantic view),适用于构建或排查语义视图/语义层。

主要能力:按官方语法起草语义视图 DDL;为每个维度、事实和度量填充同义词(synonyms)与注释(comments);通过 SELECT DISTINCT 与 LIMIT(最多 1000 行)探查事实表与维度表关系、列数据类型,以生成更有意义的注释和同义词;使用临时名称(如追加 __tmp_validate)验证 DDL,成功后再以真实名称应用;最后运行示例查询确认可用,并清理临时视图。

使用方式:一次性设置需验证 Snowflake CLI 安装(snow --help),缺失时参考官方安装文档;用 snow connection add 配置连接,后续所有验证与执行均使用该连接。每个请求先确认目标数据库、模式、角色、仓库和最终语义视图名,确认模型符合星型模式。验证命令模板:snow sql -q "<CREATE OR ALTER SEMANTIC VIEW ...>" --connection <connection_name>;若版本连接参数不同,运行 snow sql --help 查看。查询语义视图使用 SEMANTIC_VIEW 语法,例如 SELECT * FROM SEMANTIC_VIEW(my_semview_name DIMENSIONS customer.customer_market_segment METRICS orders.order_average_value) ORDER BY customer_market_segment;。

限制与要求:不得跳过验证,必须通过 Snowflake CLI 对 Snowflake 实际执行 DDL 后才可视为最终结果;优先使用临时名称验证,避免覆盖真实视图;最终定义除名称外应与验证版本一致。同义词与注释视为必需,优先读取 Snowflake 表/视图/列注释作为来源;缺失时需询问用户是否可创建、由用户提供文本或先起草建议待批准,不得未经批准自行编造。同义词仅作信息用途,不能用于引用维度、事实或度量。安装与连接配置为一次性步骤,但首次验证前需确认已完成。