SuperAPI AI 工具集

metric-views

通用与其它

查看项目

更新于 10-15 20:32

技能介绍

用途:这是 Databricks Unity Catalog 的指标视图技能,用于在 YAML 中定义可复用、受治理的业务指标,把度量定义与维度分组分离,从而灵活查询。适用场景包括定义标准化业务指标(收入、订单数、转化率)、构建可被仪表盘、Genie 和 SQL 查询共享的 KPI 层、创建复杂聚合指标(比率、去重计数、过滤度量)、定义窗口度量(移动平均、累计、环比、YTD)、在指标定义中建模星型/雪花模式连接,以及启用物化预计算。

前提条件:需要 Databricks Runtime 17.2+(YAML 1.1 版本)、具备 CAN USE 权限的 SQL 仓库、源表的 SELECT 权限、目标 schema 的 CREATE TABLE + USE SCHEMA 权限。

主要能力:用 CREATE OR REPLACE VIEW ... WITH METRICS LANGUAGE YAML AS $$ 创建指标视图,包含 source、filter、dimensions、measures,可选 joins 与 materialization。查询时所有度量必须用 MEASURE() 包裹,不支持 SELECT *。可通过 MCP 的 manage_metric_views 工具执行 create、alter、describe、query、drop、grant 操作。

使用方式:维度用于分组,度量必须为聚合表达式;查询用 MEASURE(名称),含空格的名称需反引号;JOIN 必须写在 YAML 定义中,不能写在查询 SQL 里。

限制:需 DBR 17.2+(v1.1)或 16.4+(v0.1);物化目前为实验性且需 Serverless 计算;SELECT * 不支持,度量必须显式列出;连接不可在查询时动态添加。