databricks-metric-views — скилл для Claude Code
Скилл помогает описывать бизнес-метрики в YAML и проверять, годится ли показатель для metric view вообще.
npx skills add databricks/databricks-agent-skills --skill databricks-metric-views -a claude-codeЧто делает databricks-metric-views
Скилл ведёт от профилирования схемы к готовому определению метрики. Внутри — советчик по metric views, справочник паттернов YAML, правила запросов через MEASURE() и раздел про интеграцию с Genie. Отдельно разобран пограничный случай: если показатель не пересчитывается на лету (зависит от фильтра пользователя, считается по сущности до агрегации или сходится итеративно), его место — управляемая SQL-функция Unity Catalog, а не metric view.
Для работы нужен Databricks CLI версии 1.0.0 и выше, SQL warehouse с правом CAN USE, SELECT на исходных таблицах и CREATE TABLE с USE SCHEMA в целевой схеме. YAML версии 1.1 требует Databricks Runtime 17.2+, а синонимы, display_name и format — 17.3+. Без CLI скилл не развернётся.
Определение метрики можно положить под контроль версий: полный SQL-текст коммитится в репозиторий и применяется через bundle-managed SQL job, потому что отдельного ресурса под metric view в Declarative Automation Bundles нет. Дальше метрики читают дашборды, Genie и обычные SQL-запросы — определения у всех одни и те же.
Какие задачи решает
- описать выручку и число заказов в YAML с раздельными мерами и измерениями
- собрать слой KPI, который используют дашборды, Genie и SQL-запросы
- задать оконные меры: скользящее среднее, накопленный итог, год к дате
- проверить, пересчитывается ли показатель на лету, или ему нужна SQL-функция
- положить определение metric view в git и разворачивать его через bundle
Примеры запросов агенту
- Опиши metric view для выручки и количества заказов по схеме
main.sales. - Проверь, можно ли посчитать конверсию как metric view, или нужна управляемая SQL-функция.
- Напиши SQL-запрос к metric view с
MEASURE()и разбивкой по месяцам.
Как установить databricks-metric-views
1Через Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-metric-views -a claude-code2Вручную: положить файлы
~/.claude/skills/databricks-metric-views/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/databricks-metric-views/
1Через Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-metric-views -a codex2Вручную: положить файлы
.agents/skills/databricks-metric-views/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-metric-views -a cursor2Вручную: положить файлы
.cursor/skills/databricks-metric-views/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install databricks/databricks-agent-skills databricks-metric-views2Вручную: положить файлы
.github/skills/databricks-metric-views/SKILL.md1Через Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-metric-views -a gemini-cli2Командой платформы
gemini skills install https://github.com/databricks/databricks-agent-skills --path skills/databricks-metric-viewsВручную: положить файлы
.devin/skills/databricks-metric-views/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-metric-views -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о databricks-metric-views
Как установить databricks-metric-views в Claude Code?
Выполните npx skills add databricks/databricks-agent-skills --skill databricks-metric-views -a claude-code. Файл скилла окажется по пути ~/.claude/skills/databricks-metric-views/SKILL.md.
Что делает databricks-metric-views?
Помогает описывать управляемые бизнес-метрики Unity Catalog в YAML: меры, измерения, оконные вычисления. Плюс подсказывает, когда показатель в metric view не укладывается и его надо вынести в SQL-функцию.
Что нужно, чтобы скилл заработал?
Databricks CLI версии 1.0.0 или выше, SQL warehouse с правом CAN USE и права на исходные и целевые таблицы. Для YAML версии 1.1 нужен Databricks Runtime 17.2+, для синонимов и display_name — 17.3+.
