databricks-core

Databricks

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

产品技能

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

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

对于数据发现、探索和查询生成——查找表、回答有关数据的自然语言问题或生成 SQL——请使用
databricks-data-discovery（它会先询问 Genie One，然后回退到手动探索）。如果未安装，请使用下面的 AI 工具命令和
手动数据探索。

先决条件

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

   • 如果 CLI 缺失或过旧（< v0.292.0）：停止。不要继续或绕过缺失的 CLI。
   • 阅读 CLI 安装 参考文件并按照说明指导用户完成安装。
   • 注意：在沙盒环境（Cursor IDE、容器）中，安装命令会写入工作区之外，可能被阻止。请将安装命令呈现给用户，并请他们在自己的终端中运行。
   • 例外： 如果 CLI 安装被阻止（沙盒容器、受限环境），请询问用户是否回退到直接 REST API 调用，使用 shell 中存在的 DATABRICKS_HOST 和 DATABRICKS_TOKEN 环境变量。请参阅 Databricks REST API 文档。

2. 已认证：databricks auth profiles

   • 如果未认证：请参阅 CLI 身份验证

配置文件选择 - 关键

切勿自动选择配置文件。

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

Claude Code - 重要

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

# 有效：--profile 标志
databricks apps list --profile my-workspace

# 有效：使用 && 链接
export DATABRICKS_CONFIG_PROFILE=my-workspace && databricks apps list

# 无效：单独命令
export DATABRICKS_CONFIG_PROFILE=my-workspace
databricks apps list  # 配置文件未设置！

数据探索 — 使用 AI 工具

使用这些命令，而不是手动浏览目录/架构/表：

# 发现表结构（列、类型、示例数据、统计信息）
databricks experimental aitools tools discover-schema catalog.schema.table --profile <PROFILE>

# 运行临时 SQL 查询
databricks experimental aitools tools query "SELECT * FROM table LIMIT 10" --profile <PROFILE>

# 查找默认仓库
databricks experimental aitools tools get-default-warehouse --profile <PROFILE>

名称是字面量。 使用给定的目录/架构/表名称，切勿将连字符改为下划线或进行其他规范化。在 SQL 中，对包含特殊字符的名称部分使用反引号引用（例如 `my-catalog`.schema.table）；未加引号的连字符会导致解析错误。

这些命令是运行已知 SQL 和分析的一等公民——Genie 不是必需的。对于自然语言数据问题、定位无法确定的数据或从问题生成查询，如果安装了 databricks-data-discovery 技能（见上文），请优先使用它。有关完整命令面、引用规则和故障排除，请参阅 手动数据探索。

快速参考

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

# 当前用户
databricks current-user me --profile <PROFILE>

# 列出资源
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 — 位置参数（不是标志！）
databricks catalogs list --profile <PROFILE>

# ✅ 正确：位置参数
databricks schemas list <CATALOG> --profile <PROFILE>
databricks tables list <CATALOG> <SCHEMA> --profile <PROFILE>
databricks tables get <CATALOG>.<SCHEMA>.<TABLE> --profile <PROFILE>

# ❌ 错误：这些标志/命令不存在
# databricks schemas list --catalog-name <CATALOG>    ← 将失败
# databricks tables list --catalog <CATALOG>           ← 将失败
# databricks sql-warehouses list                       ← 不存在，请使用 `warehouses list`
# databricks execute-statement                         ← 不存在，请使用 `experimental aitools tools query`
# databricks sql execute                               ← 不存在，请使用 `experimental aitools tools query`

# 如有疑问，请查看帮助：
# databricks schemas list --help

# 获取详细信息
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 标志或先进行身份验证
configuration does not support OAuth tokens	该命令需要 OAuth（例如 databricks apps logs）。使用 databricks auth login --host <URL> --profile <PROFILE> 重新进行身份验证。请参阅 CLI 身份验证。
PERMISSION_DENIED	检查工作区/UC 权限
RESOURCE_DOES_NOT_EXIST	验证资源名称/ID 和配置文件

按任务必读

任务	继续之前请阅读
首次设置	CLI 安装
身份验证问题 / 新工作区	CLI 身份验证
探索表/架构	手动数据探索（或已安装的 databricks-data-discovery）
部署作业/管道	使用 /databricks-dabs

参考指南

• CLI 安装
• CLI 身份验证
• 手动数据探索