databricks-core

Databricks

Databricks CLI、驗證和資料探索的核心技能。

產品技能

針對特定產品，請使用專用技能：

• databricks-jobs - Lakeflow Jobs 開發與部署
• databricks-pipelines - Lakeflow Spark Declarative Pipelines（批次和串流資料管線）
• databricks-apps - 全端 TypeScript 應用程式開發與部署
• databricks-lakebase - Lakebase Postgres Autoscaling 專案管理
• 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 工具

請使用這些工具，而不是手動瀏覽 catalog/schema/table：

# 探索資料表結構（欄位、型別、範例資料、統計資料）
databricks experimental aitools tools discover-schema catalog.schema.table --profile <PROFILE>

# 執行臨時 SQL 查詢
databricks experimental aitools tools query "SELECT * FROM table LIMIT 10" --profile <PROFILE>

# 尋找預設 warehouse
databricks experimental aitools tools get-default-warehouse --profile <PROFILE>

名稱是字面值。 請完全按照提供的 catalog/schema/table 名稱使用 — 絕不要將連字號改為底線，或進行其他正規化。在 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）
部署 jobs/pipelines	使用 /databricks-dabs

參考指南

• CLI 安裝
• CLI 驗證
• 手動資料探索