> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Databricks

> Connect Databricks to Langdock 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 Langdock to explore your Unity Catalog — browsing catalogs, schemas, and tables, and searching for datasets directly from your conversations.

<Info>
  **Authentication:** API Key (Personal Access Token)
  **Category:** Data & Analytics
  **Availability:** All workspace plans
</Info>

## Prerequisites

* A Databricks workspace with Unity Catalog enabled
* Permission to generate personal access tokens in your workspace

## Setup

<Steps>
  <Step title="Generate a Personal Access Token">
    Follow [Databricks' guide on Personal Access Tokens](https://docs.databricks.com/en/dev-tools/auth/pat) to generate a token in your workspace settings.
  </Step>

  <Step title="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`.
  </Step>

  <Step title="Navigate to Integrations in Langdock">
    Go to [Integrations](https://app.langdock.com/integrations) and find **Databricks** in the list.
  </Step>

  <Step title="Enter your credentials">
    Enter your workspace URL and personal access token, then save.
  </Step>

  <Step title="Start using Databricks in Langdock">
    Tag the integration with `@` in any agent to start exploring your data catalog.
  </Step>
</Steps>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="Catalog Discovery" icon="database">
    Browse catalogs, schemas, and tables across your Unity Catalog
  </Card>

  <Card title="Table Exploration" icon="table">
    Get detailed metadata for tables including column types, descriptions, and tags
  </Card>

  <Card title="Data Search" icon="magnifying-glass">
    Search for tables by name across catalogs when you know part of the dataset name
  </Card>

  <Card title="Volume Browsing" icon="folder">
    List volumes within schemas to find unstructured data storage locations
  </Card>
</CardGroup>

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