databricks

Databricks

Databricks CLI、認証、データ探索に関するコアスキルです。

製品別スキル

特定の製品については、専用のスキルを使用してください。

• databricks-jobs - Lakeflow Jobs の開発とデプロイ
• databricks-pipelines - Lakeflow Spark Declarative Pipelines（バッチおよびストリーミングのデータパイプライン）
• databricks-apps - TypeScript によるフルスタックアプリの開発とデプロイ
• databricks-lakebase - Lakebase Postgres Autoscaling のプロジェクト管理

前提条件

1. CLI がインストールされていること：databricks --version を実行して確認してください。

   • CLI が見つからない場合、または古いバージョン（< v0.292.0）の場合は、作業を中止してください。不足している CLI の回避策を試してはいけません。
   • CLI Installation のリファレンスファイルを読み、ユーザーにインストール方法を案内する手順に従ってください。
   • 注：サンドボックス環境（Cursor IDE、コンテナー）では、インストールコマンドがワークスペース外に書き込むため、ブロックされる場合があります。インストールコマンドをユーザーに提示し、ユーザー自身のターミナルで実行するよう依頼してください。

2. 認証済みであること：databricks auth profiles

   • 認証されていない場合は、CLI Authentication を参照してください。

プロファイルの選択 — 重要

プロファイルを自動選択してはいけません。

1. プロファイルを一覧表示します：databricks auth profiles
2. ワークスペース URL とともに、すべてのプロファイルをユーザーに提示します。
3. ユーザーに選択してもらいます（プロファイルが 1 つしかない場合も同様です）。
4. 必要に応じて、新しいプロファイルの作成を提案します。

Claude Code — 重要

Bash コマンドはそれぞれ別のシェルセッションで実行されます。

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

詳しくは、Data Exploration を参照してください。

クイックリファレンス

⚠️ 重要：一部のコマンドはフラグではなく、位置引数を使用します。

# 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 Installation
認証の問題／新しいワークスペース	CLI Authentication
テーブル／スキーマの探索	Data Exploration
ジョブ／パイプラインのデプロイ	Declarative Automation Bundles

リファレンスガイド

• CLI Installation
• CLI Authentication
• Data Exploration
• Declarative Automation Bundles