用途:这是 Databricks CLI 的父级/入口技能,覆盖认证、配置文件选择、bundles 以及数据探索等基础操作。具体产品有各自专用技能,如 databricks-jobs、databricks-pipelines、databricks-serverless、databricks-apps、databricks-lakebase、databricks-model-serving;数据发现与查询生成建议使用 databricks-data-discovery。
前提:CLI 必须已安装且版本不低于 v1.0.0,过旧需升级而非绕过。沙箱环境(如 Cursor IDE、容器)中安装命令可能被阻止,应把命令交给用户自行在终端运行。若安装被阻止,可询问用户是否回退到使用 DATABRICKS_HOST 和 DATABRICKS_TOKEN 环境变量直接调用 REST API。需先通过 databricks auth profiles 确认已认证。
配置文件选择:绝不自动选择配置文件。用 databricks auth profiles 列出全部配置文件及工作区 URL,交由用户选择,即使只有一个也要确认,必要时可创建新配置文件。在 Claude Code 中每条 Bash 命令独立会话,需用 --profile 标志或 export DATABRICKS_CONFIG_PROFILE=... && 命令链,分开写会失效。
数据探索:可用 databricks experimental aitools tools discover-schema catalog.schema.table --profile <PROFILE> 查看表结构,用 databricks experimental aitools tools query "SELECT * FROM table LIMIT 10" --profile <PROFILE> 执行 SQL,用 databricks experimental aitools tools get-default-warehouse --profile <PROFILE> 查找默认仓库。名称须原样使用,含特殊字符的部分在 SQL 中用反引号引用。
常用命令:databricks current-user me、apps/jobs/clusters/warehouses/pipelines/serving-endpoints list 等。注意 Unity Catalog 使用位置参数而非标志,如 databricks schemas list <CATALOG>、databricks tables list <CATALOG> <SCHEMA>、databricks tables get <CATALOG>.<SCHEMA>.<TABLE>;不存在 --catalog-name、--catalog 等标志,也不存在 sql-warehouses list、execute-statement、sql execute 等命令。bundles 相关命令包括 bundle init、bundle validate、bundle deploy -t <TARGET>、bundle run <RESOURCE> -t <TARGET>。
限制:资料未提供收费、价格、平台支持范围等细节。遇到 cannot configure default credentials、configuration does not support OAuth tokens、PERMISSION_DENIED、RESOURCE_DOES_NOT_EXIST 等错误时,按对应方式处理,如重新认证或检查权限。