Databricks
Connect Databricks to ajan to explore your Unity Catalog and discover data assets from your conversations
Overview
Databricks is a unified analytics platform for data engineering, data science, and machine learning. Once connected, you can use ajan to explore your Unity Catalog — browsing catalogs, schemas, and tables, and searching for datasets directly from your conversations.
Prerequisites
- A Databricks workspace with Unity Catalog enabled
- Permission to generate personal access tokens in your workspace
Setup
Generate a Personal Access Token
Follow Databricks' guide on Personal Access Tokens to generate a token in your workspace settings.
Copy your workspace URL
Your workspace URL is the base URL you use to access Databricks, e.g. https://your-workspace.azuredatabricks.net or https://your-workspace.cloud.databricks.com.
Navigate to Integrations in ajan
Go to Integrations and find Databricks in the list.
Enter your credentials
Enter your workspace URL and personal access token, then save.
Start using Databricks in ajan
Tag the integration with @ in any agent to start exploring your data catalog.
Common Use Cases
- Catalog Discovery — Browse catalogs, schemas, and tables across your Unity Catalog
- Table Exploration — Get detailed metadata for tables including column types, descriptions, and tags
- Data Search — Search for tables by name across catalogs when you know part of the dataset name
- Volume Browsing — List volumes within schemas to find unstructured data storage locations
Troubleshooting
| Issue | Solution |
|---|---|
| Authentication failed | Verify the token is correct and hasn't expired — generate a new one if needed |
| Workspace not found | Check the workspace URL format: https://[workspace].azuredatabricks.net |
| Catalog not accessible | Ensure the token's user has the necessary Unity Catalog permissions |
| Token expired | Generate a new personal access token in Databricks settings and update the integration |