databricks-core

Operate Databricks CLI for authentication, profile management, data exploration, and bundle deployment.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/pgoell/pgoell-claude-tools --skill databricks-core-pgoell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: databricks-core
Source: https://github.com/pgoell/pgoell-claude-tools/tree/main/plugins/databricks/skills/databricks-core
Command: npx skills add https://github.com/pgoell/pgoell-claude-tools --skill databricks-core-pgoell

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with the Databricks CLI involves tricky authentication setup, multi-profile workspace management, and error-prone commands with positional arguments that are easy to get wrong. This Skill provides up-to-date, verified guidance for Databricks CLI operations so commands work correctly the first time, especially inside Claude Code where each Bash command runs in a separate shell session. ## Core Features & Use Cases - OAuth Authentication & Profile Management: Set up OAuth2 login with descriptive profile names, list and switch between workspace profiles, and troubleshoot credential errors. - AI-Powered Data Exploration: Use databricks experimental aitools tools to discover table schemas, run ad-hoc SQL queries, and find tables by keyword via information_schema instead of manually iterating catalogs. - Resource & Bundle Operations: List and inspect apps, jobs, clusters, warehouses, pipelines, and Unity Catalog objects, plus init, validate, deploy, and run Databricks bundles. - Use Case: You need to explore an unfamiliar table in a Databricks workspace. The Skill guides you to select the right profile, search system.information_schema.tables by keyword, run discover-schema for columns and sample data, then execute targeted SQL queries. ## Quick Start Ask the assistant to list your Databricks profiles and explore the schema of a specific table using the databricks CLI.

Frequently Asked Questions about databricks-core

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I authenticate the Databricks CLI with OAuth?

Run `databricks auth login --host <workspace-url> --profile <profile-name>` to start the OAuth2 flow. A browser opens for login, and credentials are saved to ~/.databrickscfg. Always use a descriptive profile name rather than DEFAULT, and never use Personal Access Tokens unless explicitly required.

How do I explore table schemas in Databricks from the CLI?

Use `databricks experimental aitools tools discover-schema catalog.schema.table --profile <PROFILE>` to get columns, types, sample data, and null counts. To find tables by keyword, query `system.information_schema.tables` instead of manually listing catalogs and schemas.

Why does my Databricks profile not persist between commands in Claude Code?

Each Bash command in Claude Code runs in a separate shell session, so exported environment variables do not carry over. Use the `--profile` flag on every command, or chain commands with `export DATABRICKS_CONFIG_PROFILE=name && databricks ...`.

How do I run SQL queries from the Databricks CLI?

Use `databricks experimental aitools tools query "SELECT ..." --profile <PROFILE>`. It auto-detects an available SQL warehouse, or you can set DATABRICKS_WAREHOUSE_ID. Commands like `databricks sql execute` do not exist.

What does 'cannot configure default credentials' mean in Databricks CLI?

This error means no valid authentication profile is configured. Run `databricks auth profiles` to list existing profiles, then retry your command with `--profile <name>`. If no profiles exist, authenticate with `databricks auth login --host <url> --profile <name>`.