> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unstructured.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Databricks Volumes
This article covers connecting Unstructured to Databricks Volumes.
For information about connecting Unstructured to Delta Tables in Databricks instead, see
[Delta Tables in Databricks](/ui/destinations/databricks-delta-table).
If you're new to Unstructured, read this note first.
Before you can create a destination connector, you must first sign in to your Unstructured account:
* If you do not already have an Unstructured account, [sign up for free](https://unstructured.io/?modal=try-for-free). After you sign up, you are automatically signed in to your new Unstructured **Let's Go** account, at [https://platform.unstructured.io](https://platform.unstructured.io).
To sign up for a **Business** account instead, [contact Unstructured Sales](https://unstructured.io/?modal=contact-sales), or [learn more](/ui/overview#how-am-i-billed%3F).
* If you already have an Unstructured **Let's Go**, **Pay-As-You-Go**, or **Business SaaS** account and are not already signed in, sign in to your account at
[https://platform.unstructured.io](https://platform.unstructured.io). For other types of **Business** accounts, see your Unstructured account administrator for sign-in instructions,
or email Unstructured Support at [support@unstructured.io](mailto:support@unstructured.io).
After you sign in, the [Unstructured user interface](/ui/overview) (UI) appears, which you use to create your destination connector.
After you create the destination connector, add it along with a
[source connector](/ui/sources/overview) to a [workflow](/ui/workflows). Then run the worklow as a
[job](/ui/jobs). To learn how, try out the [hands-on UI quickstart](/ui/quickstart#remote-quickstart) or watch the 4-minute
[video tutorial](https://www.youtube.com/watch?v=Wn2FfHT6H-o).
You can also create destination connectors with the Unstructured API.
[Learn how](/api-reference/workflow/destinations/overview).
If you need help, email Unstructured Support at [support@unstructured.io](mailto:support@unstructured.io).
You are now ready to start creating a destination connector! Keep reading to learn how.
Send processed data from Unstructured to Databricks Volumes.
The requirements are as follows.
* A Databricks account on [AWS](https://docs.databricks.com/getting-started/free-trial.html),
[Azure](https://learn.microsoft.com/azure/databricks/getting-started/), or
[GCP](https://docs.gcp.databricks.com/getting-started/index.html).
* A workspace within the Databricks account for [AWS](https://docs.databricks.com/admin/workspace/index.html),
[Azure](https://learn.microsoft.com/azure/databricks/admin/workspace/), or
[GCP](https://docs.gcp.databricks.com/admin/workspace/index.html).
* The workspace's URL. Get the workspace URL for
[AWS](https://docs.databricks.com/workspace/workspace-details.html#workspace-instance-names-urls-and-ids),
[Azure](https://learn.microsoft.com/azure/databricks/workspace/workspace-details#workspace-instance-names-urls-and-ids),
or [GCP](https://docs.gcp.databricks.com/workspace/workspace-details.html#workspace-instance-names-urls-and-ids).
Examples:
* AWS: `https://.cloud.databricks.com`
* Azure: `https://adb-..azuredatabricks.net`
* GCP: `https://..gcp.databricks.com`
Do not add a trailing slash (`/`) to the workspace URL.
* The Databricks authentication details. For more information, see the documentation for
[AWS](https://docs.databricks.com/dev-tools/auth/index.html),
[Azure](https://learn.microsoft.com/azure/databricks/dev-tools/auth/),
or [GCP](https://docs.gcp.databricks.com/dev-tools/auth/index.html).
For the [Unstructured UI](/ui/overview) or the [Unstructured API](/api-reference/overview), the following Databricks authentication types are supported:
* Databricks OAuth machine-to-machine (M2M) authentication for\
[AWS](https://docs.databricks.com/dev-tools/auth/oauth-m2m.html),
[Azure](https://learn.microsoft.com/azure/databricks/dev-tools/auth/oauth-m2m), or
[GCP](https://docs.gcp.databricks.com/dev-tools/auth/oauth-m2m.html).
You will need the **Client ID** (or **UUID** or **Application** ID) and OAuth **Secret** (client secret) values for the corresponding service principal.
Note that for Azure, only Databricks managed service principals are supported. Microsoft Entra ID managed service principals are not supported.
The following video shows how to create a Databricks managed service principal:
* Databricks personal access token authentication for
[AWS](https://docs.databricks.com/dev-tools/auth/pat.html),
[Azure](https://learn.microsoft.com/azure/databricks/dev-tools/auth/pat), or
[GCP](https://docs.gcp.databricks.com/dev-tools/auth/pat.html).
You will need the personal access token's value.
The following video shows how to create a Databricks personal access token:
For [Unstructured Ingest](/open-source/ingestion/overview), the following Databricks authentication types are supported:
* For Databricks personal access token authentication for
[AWS](https://docs.databricks.com/dev-tools/auth/pat.html),
[Azure](https://learn.microsoft.com/azure/databricks/dev-tools/auth/pat), or
[GCP](https://docs.gcp.databricks.com/dev-tools/auth/pat.html): The personal access token's value.
The following video shows how to create a Databricks personal access token:
* For username and password (basic) authentication ([AWS](https://docs.databricks.com/archive/dev-tools/basic.html) only): The user's name and password values.
* For OAuth machine-to-machine (M2M) authentication ([AWS](https://docs.databricks.com/dev-tools/auth/oauth-m2m.html),
[Azure](https://learn.microsoft.com/azure/databricks/dev-tools/auth/oauth-m2m), and
[GCP](https://docs.gcp.databricks.com/dev-tools/auth/oauth-m2m.html)): The client ID and OAuth secret values for the corresponding service principal.
* For OAuth user-to-machine (U2M) authentication ([AWS](https://docs.databricks.com/dev-tools/auth/oauth-u2m.html),
[Azure](https://learn.microsoft.com/azure/databricks/dev-tools/auth/oauth-u2m), and
[GCP](https://docs.gcp.databricks.com/dev-tools/auth/oauth-u2m.html)): No additional values.
* For Azure managed identities (formerly Managed Service Identities (MSI) authentication) ([Azure](https://learn.microsoft.com/azure/databricks/dev-tools/auth/azure-mi) only): The client ID value for the corresponding managed identity.
* For Microsoft Entra ID service principal authentication ([Azure](https://learn.microsoft.com/azure/databricks/dev-tools/auth/azure-sp) only): The tenant ID, client ID, and client secret values for the corresponding service principal.
* For Azure CLI authentication ([Azure](https://learn.microsoft.com/azure/databricks/dev-tools/auth/azure-cli) only): No additional values.
* For Microsoft Entra ID user authentication ([Azure](https://learn.microsoft.com/azure/databricks/dev-tools/user-aad-token) only): The Entra ID token for the corresponding Entra ID user.
* For Google Cloud Platform credentials authentication ([GCP](https://docs.gcp.databricks.com/dev-tools/auth/gcp-creds.html) only): The local path to the corresponding Google Cloud service account's credentials file.
* For Google Cloud Platform ID authentication ([GCP](https://docs.gcp.databricks.com/dev-tools/auth/gcp-id.html) only): The Google Cloud service account's email address.
* The name of the parent catalog in Unity Catalog for
[AWS](https://docs.databricks.com/catalogs/create-catalog.html),
[Azure](https://learn.microsoft.com/azure/databricks/catalogs/create-catalog), or
[GCP](https://docs.gcp.databricks.com/catalogs/create-catalog.html) for the volume.
* The name of the parent schema (formerly known as a database) in Unity Catalog for
[AWS](https://docs.databricks.com/schemas/create-schema.html),
[Azure](https://learn.microsoft.com/azure/databricks/schemas/create-schema), or
[GCP](https://docs.gcp.databricks.com/schemas/create-schema.html) for the volume.
* The name of the volume in Unity Catalog for [AWS](https://docs.databricks.com/tables/managed.html),
[Azure](https://learn.microsoft.com/azure/databricks/tables/managed), or
[GCP](https://docs.gcp.databricks.com/tables/managed.html), and optionally any path in that volume that you want to access directly, beginning with the volume's root.
* The Databricks workspace user or service principal must have the following *minimum* set of privileges to read from or write to the
existing volume in Unity Catalog:
* `USE CATALOG` on the volume's parent catalog in Unity Catalog.
* `USE SCHEMA` on the volume's parent schema (formerly known as a database) in Unity Catalog.
* `READ VOLUME` and `WRITE VOLUME` on the volume.
The following videos show how to create and set privileges for a catalog, schema (formerly known as a database), and volume in Unity Catalog.
Learn more about how to check and set Unity Catalog privileges for
[AWS](https://docs.databricks.com/data-governance/unity-catalog/manage-privileges/index.html#show-grant-and-revoke-privileges),
[Azure](https://learn.microsoft.com/azure/databricks/data-governance/unity-catalog/manage-privileges/#grant), or
[GCP](https://docs.gcp.databricks.com/data-governance/unity-catalog/manage-privileges/index.html#show-grant-and-revoke-privileges).
To create the destination connector:
1. On the sidebar, click **Connectors**.
2. Click **Destinations**.
3. Cick **New** or **Create Connector**.
4. Give the connector some unique **Name**.
5. In the **Provider** area, click **Databricks Volumes**.
6. Click **Continue**.
7. Follow the on-screen instructions to fill in the fields as described later on this page.
8. Click **Save and Test**.
Fill in the following fields:
* **Name** (*required*): A unique name for this connector.
* **Host** (*required*): The Databricks workspace host URL.
Do not add a trailing slash (`/`) to the host URL.
* **Catalog** (*required*): The name of the catalog to use.
* **Schema** : The name of the associated schema. If not specified, **default** is used.
* **Volume** (*required*): The name of the associated volume.
* **Volume Path** : Any optional path to access within the volume.
* For **Authentication Method**, if you select **Service Principal**, you must also specify the following:
* **OAuth Secret** (*required*): The associated OAuth **Secret** value for the Databricks managed service principal that has the appropriate privileges to the volume.
* **UUID** (*required*): The **Client ID** (or **UUID** or **Application ID**) value for the Databricks managed service principal that has appropriate privileges to the volume.
* For **Authentication Method**, if you select **Token**, you must also specify the Databricks personal access token's value in the **Token** field.