Databricks CLI 核心技能：身份验证、数据探索与命令行工具使用指南

databricks by databricks/databricks-agent-skills

162 周安装量

49 GitHub Stars

GitHub

安装命令

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

云服务命令行工具数据处理

🇨🇳中文介绍

Databricks

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

产品技能

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

databricks-jobs - Lakeflow Jobs 开发与部署
databricks-pipelines - Lakeflow Spark 声明式管道（批处理和流式数据管道）
databricks-apps - 全栈 TypeScript 应用开发与部署

前提条件

已安装 CLI：运行 databricks --version 进行检查。
- 如果 CLI 缺失或版本过旧（< v0.288.0）：请停止。不要继续操作或尝试绕过缺失的 CLI。
- 请阅读 CLI 安装参考文件，并按照说明引导用户完成安装。
- 注意：在沙盒环境（如 Cursor IDE、容器）中，安装命令会写入工作区外部，可能会被阻止。请将安装命令呈现给用户，并要求他们在自己的终端中运行。
已通过身份验证：databricks auth profiles
- 如果未通过：请参阅 CLI 身份验证

配置文件选择 - 至关重要

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

Azure Data Explorer (Kusto) 查询技能：KQL数据分析、日志遥测与时间序列处理

125,100 周安装

Azure RBAC 权限管理工具：查找最小角色、创建自定义角色与自动化分配

123,100 周安装

Azure 配额管理指南：服务限制、容量验证与配额增加方法

102,500 周安装

Azure 升级评估与自动化工具 - 轻松迁移 Functions 计划、托管层级和 SKU

90,800 周安装

# 当前用户
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>

# 捆绑包
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 身份验证
探索表/模式	数据探索
部署作业/管道	资产捆绑包

🇺🇸English

Databricks

Core skill for Databricks CLI, authentication, and data exploration.

Product Skills

For specific products, use dedicated skills:

databricks-jobs - Lakeflow Jobs development and deployment
databricks-pipelines - Lakeflow Spark Declarative Pipelines (batch and streaming data pipelines)
databricks-apps - Full-stack TypeScript app development and deployment

Prerequisites

CLI installed : Run databricks --version to check.
- If the CLI is missing or outdated ( < v0.288.0): STOP. Do not proceed or work around a missing CLI.
- Read theCLI Installation reference file and follow the instructions to guide the user through installation.
- Note: In sandboxed environments (Cursor IDE, containers), install commands write outside the workspace and may be blocked. Present the install command to the user and ask them to run it in their own terminal.
Authenticated : databricks auth profiles
- If not: see CLI Authentication

Profile Selection - CRITICAL

NEVER auto-select a profile.

List profiles: databricks auth profiles
Present ALL profiles to user with workspace URLs
Let user choose (even if only one exists)
Offer to create new profile if needed

Claude Code - IMPORTANT

Each Bash command runs in a separate shell session.

# 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!

Data Exploration — Use AI Tools

Use these instead of manually navigating catalogs/schemas/tables:

# 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>

See Data Exploration for details.

Quick Reference

⚠️ CRITICAL: Some commands use positional arguments, not flags

# 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>

Troubleshooting

Error	Solution
`cannot configure default credentials`	Use `--profile` flag or authenticate first
`PERMISSION_DENIED`	Check workspace/UC permissions
`RESOURCE_DOES_NOT_EXIST`	Verify resource name/id and profile

Required Reading by Task

Task	READ BEFORE proceeding
First time setup	CLI Installation
Auth issues / new workspace	CLI Authentication
Exploring tables/schemas	Data Exploration
Deploying jobs/pipelines	Asset Bundles

Reference Guides

Weekly Installs

Repository

databricks/data…t-skills

GitHub Stars

First Seen

Feb 14, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

github-copilot77

opencode77

cursor76

kimi-cli75

gemini-cli75

amp75

Databricks CLI 核心技能：身份验证、数据探索与命令行工具使用指南

🇨🇳中文介绍

Databricks

产品技能

前提条件

配置文件选择 - 至关重要

相关 Skills

Claude 代码 - 重要提示

数据探索 — 使用 AI 工具

快速参考

故障排除

按任务必读

参考指南

🇺🇸English

Databricks

Product Skills

Prerequisites

Profile Selection - CRITICAL

Claude Code - IMPORTANT

Data Exploration — Use AI Tools

Quick Reference

Troubleshooting

Required Reading by Task

Reference Guides

最新 Skills