databricks-genie

Translate natural-language questions into SQL queries via Genie Spaces.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/Blackkadder/databricks-apps-and-agents-workshop --skill databricks-genie-blackkadder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: databricks-genie
Source: https://github.com/Blackkadder/databricks-apps-and-agents-workshop/tree/main/.claude/skills/databricks-genie
Command: npx skills add https://github.com/Blackkadder/databricks-apps-and-agents-workshop --skill databricks-genie-blackkadder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Translating natural-language questions into SQL queries against Unity Catalog data, enabling conversational data exploration and easier data access without writing complex SQL.

Core Features & Use Cases

  • Create, update, export, import, and migrate Genie Spaces across workspaces.
  • Use the Conversation API to ask questions and receive generated SQL and results.
  • Connect Unity Catalog tables to Genie Spaces and manage sample questions, space instructions, and migrations.

Quick Start

Create a Genie Space for your Unity Catalog data with sample questions and a connected SQL warehouse.

Frequently Asked Questions about databricks-genie

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

FAQPage Schema
How do I translate natural language questions into SQL queries against Unity Catalog data?

You use Genie Spaces to translate natural language questions into SQL queries against Unity Catalog data, receiving generated SQL statements and result sets without writing complex SQL manually.

How do I migrate Genie Spaces across workspaces?

Migrating Genie Spaces across workspaces involves using the migrate_genie management tool to export and import space configurations, preserving attached sample questions and instructions.

What's the best way to create a Genie Space for my Unity Catalog tables?

The best way to create a Genie Space is using the create_or_update_genie tool to connect Unity Catalog tables, configure a SQL warehouse, and attach sample questions for conversational data exploration.

Can I use the Conversation API to ask programmatic questions to Genie Spaces?

Yes, you can use the ask_genie tool to access the Conversation API, programmatically asking questions to Genie Spaces and retrieving generated SQL and query results for automated workflows.

Does querying Unity Catalog with Genie Spaces require a connected SQL warehouse?

Querying Unity Catalog with Genie Spaces requires a connected SQL warehouse to execute the generated SQL statements and return the requested data results to the Conversation API.

How do I retrieve table schema and statistics before creating a Genie Space?

You use the get_table_stats_and_schema supporting utility to retrieve table schema and statistics before creating a Genie Space, providing the necessary metadata for accurate natural language to SQL translation.