databricks-genie

Create and manage Databricks Genie Spaces for natural language SQL exploration.

31|18|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/ThomazRossito/data-agents --skill databricks-genie-thomazrossito
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: databricks-genie
Source: https://github.com/ThomazRossito/data-agents/tree/main/skills/databricks/databricks-genie
Command: npx skills add https://github.com/ThomazRossito/data-agents --skill databricks-genie-thomazrossito

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable non-SQL users and analysts to explore Unity Catalog data and get accurate SQL-backed answers without writing queries manually, and simplify creation, cloning, and migration of curated Genie Spaces across Databricks workspaces.

Core Features & Use Cases

  • Space management: Idempotent create/update, get, list, delete, export, and import of Genie Spaces including serialized_space handling for full-config migrations.
  • Conversational querying: Ask natural language questions and follow-ups via the Conversation API to receive generated SQL, results, and context-aware responses.
  • Migration & remapping: Export serialized_space, perform catalog name remapping, and import or create_or_update spaces in target workspaces for dev/staging/prod workflows.

Quick Start

Use manage_genie(action="create_or_update", display_name="Sales Analytics", table_identifiers=["my_catalog.sales.customers","my_catalog.sales.orders"], sample_questions=["What were total sales last month?"]) to create a new Genie Space and then ask_genie(space_id="your_space_id", question="What were total sales last month?").

Frequently Asked Questions about databricks-genie

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

FAQPage Schema
How do I create a Databricks Genie Space for natural language SQL exploration?

You create a Genie Space by specifying a display name, linking Unity Catalog table identifiers, and providing sample questions. This configures a SQL warehouse-backed environment for natural language data exploration.

Can I migrate Databricks Genie Spaces between workspaces using serialized_space exports?

Yes, you can export a serialized_space file and import it into a target workspace. The migration workflow supports catalog name remapping to transition Genie Spaces across dev, staging, and prod environments.

How does the Conversation API handle natural language queries in Databricks Genie?

The Conversation API processes natural language questions by generating SQL, executing it on the SQL warehouse, and returning context-aware results. This enables non-SQL users to query Unity Catalog data without writing code.

Do I need a SQL warehouse and Unity Catalog permissions to use Databricks Genie?

Yes, appropriate workspace permissions and an active SQL warehouse are required. Genie Spaces depend on Unity Catalog tables to provide accurate, SQL-backed answers for your conversational data exploration.

What is the best way to clone and remap catalogs when importing a Genie Space?

The best way to clone and remap catalogs is exporting a serialized_space file and using the import or create_or_update action. This handles full-config migrations and catalog name remapping for target workspaces.