mcpField
D
databricks

databricks

github.com/databricks数据与数据库373205 次安装今天更新
代码仓库

关于 databricks

面向 Databricks CLI、身份验证和数据探索的核心技能，适用于管理 Databricks 工作区的用户。它强调由用户选择配置文件，并提供数据探索与常见资源操作指引。

主要功能

  1. 01指导 CLI 安装与身份验证
  2. 02要求用户选择工作区配置文件
  3. 03使用 AI 工具探索数据
  4. 04提供资源查询命令参考

适用场景

  1. 01首次配置 Databricks CLI
  2. 02浏览表结构并运行 SQL 查询
  3. 03列出工作区中的作业与集群

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/databricks/databricks-agent-skills --skill databricks

安装后在 Claude Code 中输入/databricks确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

data-exploration.md
databricks-cli-auth.md
databricks-cli-install.md
declarative-automation-bundles.md

详细介绍

Databricks

Databricks CLI、身份验证和数据探索的核心技能。

产品技能

针对特定产品，请使用专用技能：

  • databricks-jobs - Lakeflow Jobs 的开发和部署
  • databricks-pipelines - Lakeflow Spark 声明式管道（批处理和流式数据管道）
  • databricks-apps - 全栈 TypeScript 应用的开发和部署
  • databricks-lakebase - Lakebase Postgres 自动扩缩项目管理

前置条件

  1. 已安装 CLI：运行 databricks --version 进行检查。

    • 如果缺少 CLI 或版本过旧（< v0.292.0）：请停止。不要继续操作，也不要尝试绕过 CLI 缺失的问题。
    • 阅读 CLI 安装 参考文件，并按照其中的说明指导用户完成安装。
    • 注意：在沙盒环境（Cursor IDE、容器）中，安装命令会在工作区之外写入文件，可能会被阻止。向用户提供安装命令，并请他们在自己的终端中运行。

  2. 已完成身份验证：databricks auth profiles

配置文件选择 - 至关重要

绝不要自动选择配置文件。

  1. 列出配置文件：databricks auth profiles
  2. 向用户展示所有配置文件及其工作区 URL
  3. 让用户选择（即使只有一个配置文件）
  4. 如有需要，提供创建新配置文件的选项

Claude Code - 重要

每条 Bash 命令都会在单独的 shell 会话中运行。

# WORKS: --profile flag
databricks apps list --profile my-workspace

# WORKS: chained with &&
export DATABRICKS_CONFIG_PROFILE=my-workspace && databricks apps list

# DOES NOT WORK: separate commands
export DATABRICKS_CONFIG_PROFILE=my-workspace
databricks apps list  # profile not set!

数据探索 — 使用 AI 工具

请使用这些工具，不要手动浏览目录、架构和表：

# discover table structure (columns, types, sample data, stats)
databricks experimental aitools tools discover-schema catalog.schema.table --profile <PROFILE>

# run ad-hoc SQL queries
databricks experimental aitools tools query "SELECT * FROM table LIMIT 10" --profile <PROFILE>

# find the default warehouse
databricks experimental aitools tools get-default-warehouse --profile <PROFILE>

详情请参阅数据探索。

快速参考

⚠️ 至关重要：某些命令使用位置参数，而不是标志

# current user
databricks current-user me --profile <PROFILE>

# list resources
databricks apps list --profile <PROFILE>
databricks jobs list --profile <PROFILE>
databricks clusters list --profile <PROFILE>
databricks warehouses list --profile <PROFILE>
databricks pipelines list --profile <PROFILE>
databricks serving-endpoints list --profile <PROFILE>

# ⚠️ Unity Catalog — POSITIONAL arguments (NOT flags!)
databricks catalogs list --profile <PROFILE>

# ✅ CORRECT: positional args
databricks schemas list <CATALOG> --profile <PROFILE>
databricks tables list <CATALOG> <SCHEMA> --profile <PROFILE>
databricks tables get <CATALOG>.<SCHEMA>.<TABLE> --profile <PROFILE>

# ❌ WRONG: these flags/commands DON'T EXIST
# databricks schemas list --catalog-name <CATALOG>    ← WILL FAIL
# databricks tables list --catalog <CATALOG>           ← WILL FAIL
# databricks sql-warehouses list                       ← doesn't exist, use `warehouses list`
# databricks execute-statement                         ← doesn't exist, use `experimental aitools tools query`
# databricks sql execute                               ← doesn't exist, use `experimental aitools tools query`

# When in doubt, check help:
# databricks schemas list --help

# get details
databricks apps get <NAME> --profile <PROFILE>
databricks jobs get --job-id <ID> --profile <PROFILE>
databricks clusters get --cluster-id <ID> --profile <PROFILE>

# bundles
databricks bundle init --profile <PROFILE>
databricks bundle validate --profile <PROFILE>
databricks bundle deploy -t <TARGET> --profile <PROFILE>
databricks bundle run <RESOURCE> -t <TARGET> --profile <PROFILE>

故障排除

错误解决方案
cannot configure default credentials使用 --profile 标志，或先完成身份验证
PERMISSION_DENIED检查工作区/UC 权限
RESOURCE_DOES_NOT_EXIST验证资源名称/ID 和配置文件

按任务阅读必需文档

任务继续操作前请阅读
首次设置CLI 安装
身份验证问题/新工作区CLI 身份验证
浏览表/架构数据探索
部署作业/管道声明式自动化包

参考指南

评论

支持 Markdown