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

# Databricks

export const CommonDatasourceMoreInformation = ({datasource = "the data source", advancedurl = "", siteName = "CData Sync", driverVersion = ""}) => {
  return <>
      <p>
        For more information about interactions between {siteName} and {datasource}, see{' '}
        <a href={`https://cdn.cdata.com/help/${advancedurl}${driverVersion}/synch/default.htm`}>
          {datasource} Connector for {siteName}
        </a>.
      </p>
    </>;
};

export const CommonDatasourceAddConnector = ({datasource = "the data source", title = "the connector", destination = false, siteNameShort = "Sync"}) => {
  return <>
      <p>
        To enable {siteNameShort} to use data from {datasource}, you first must add the
        connector, as follows:
      </p>
      <ol>
        <li>Open the <strong>Connections</strong> page of the {siteNameShort} dashboard.</li>
        <li>Click <strong>Add Connection</strong> to open the <strong>Select Connectors</strong> page.</li>
        <li>
          Click the <strong>{destination ? "Destinations" : "Sources"}</strong> tab and locate
          the <strong>{title}</strong> row.
        </li>
        <li>
          Click the <strong>Configure Connection</strong> icon at the end of that row to open
          the <strong>New Connection</strong> page. This action opens the{' '}
          <strong>Add Connection</strong> dialog box.
          <br />
          <strong>Note:</strong> If the <strong>Configure Connection</strong> icon is not
          available, click the <strong>Download Connector</strong> icon to install
          the {title} connector.
        </li>
        <li>Enter a name for your connection in the <strong>Add Connection</strong> dialog box.</li>
        <li>Click <strong>Add</strong> to open the <strong>Settings</strong> tab for your connector.</li>
      </ol>
      <p>
        For more information about installing new connectors, see{' '}
        <a href="../connections">Connections</a>.
      </p>
    </>;
};

export const CommonDatasourceIntroSource = ({datasource = "the data source", siteName = "CData Sync"}) => {
  return <p>
      You can use the {datasource} connector from the {siteName} application to capture data
      from {datasource} and move it to any supported destination. To do so, you need to add
      the connector, authenticate to the connector, and complete your connection.
    </p>;
};

export const driverVersion = "M";

export const siteNameShort = "Sync";

export const siteName = "CData Sync";

export const datasource = "Databricks";
export const pageTitle = "Databricks";
export const advancedurl = "LK";
export const oauthschemes = "AzureAD";

<CommonDatasourceIntroSource datasource={datasource} siteName={siteName} />

## Add the Databricks Connector

<CommonDatasourceAddConnector datasource={datasource} title={pageTitle} destination={false} siteNameShort={siteNameShort} />

## Authenticate to Databricks

After you add the connector, you need to set the required properties.

* **Server:** Enter the host name or the IP address of the server that hosts the {pageTitle} database.
* **HTTP Path:** Enter the HTTP path of your {pageTitle} cluster.
* **Catalog:** Enter the name of your catalog. The default catalog name is **hive\_metastore**.

{siteName} supports authenticating to {pageTitle} in several ways. Select your authentication method below to proceed to the relevant section that contains the authentication details.

* [**Personal Access Token**](#personal-access-token) (default)
* [**Basic**](#basic)
* [**User-to-Machine Authentication**](#user-to-machine-authentication)
* [**Machine-to-Machine Authentication**](#machine-to-machine-authentication)
* [**Azure Service Principal**](#azure-service-principal)
* [**Azure Active Directory**](#azure-active-directory)

### Personal Access Token

To connect with a personal access token (PAT), set the following properties:

* **Auth Scheme:** Select **PersonalAccessToken**.
* **Token:** Enter the PAT that you use to connect to {pageTitle} server.

  To obtain your token:

  1. In your Azure {pageTitle} workspace, click your username in the top bar and select **User Settings > Access Tokens**.
  2. Click **Developer**.
  3. Click **Manage** (next to **Access tokens**). Then, click **Generate new token > Generate**.

  Copy and save your new token because it will not be displayed again.

### Basic

To connect with your user credentials, set the following properties:

* **Auth Scheme:** Select **Basic**.
* **User:** Enter the username that you use to authenticate to your {pageTitle} account.
* **Token:** Enter the token that you use to authenticate to your {pageTitle} account.

### User-to-Machine Authentication

User-to-machine (U2M) authentication enables you to grant tools or applications (for example, a command-line interface) access to your workspace. To authenticate via with this method, set the following properties:

* **Auth Scheme:** Select **OAuthU2M**.
* **OAuth Level:** Select the level from which you want to generate an access token.
  * **AccountLevel:** A {pageTitle} account represents a single entity that can include multiple workspaces. You can use accounts that are enabled for Unity Catalog to manage users and their access to data centrally across all of the workspaces in the account.

    For this level, you need to enter your account identifier (Id) in the **{pageTitle} Account Id** text box.

  * **WorkspaceLevel (default):** In {pageTitle}, a workspace is a {pageTitle} deployment in the cloud that functions as an environment for your team to access {pageTitle} assets.

    No other settings are necessary for this level.

### Machine-to-Machine Authentication

Machine-to-machine (M2M) authentication verifies the identity of devices or applications that communicate over a network. To authenticate with this method, set the following properties:

* **Auth Scheme:** Select **OAuthM2M**.
* **OAuth Client Id:** Enter the client Id that you were assigned when you registered your application with an OAuth authorization server.
* **OAuth Client Secret:** Enter the client secret that you were assigned when you registered your application with an OAuth authorization server.
* **OAuth Level:** Select the level from which you want to generate an access token.
  * **AccountLevel:**  A {pageTitle} account represents a single entity that can include multiple workspaces. You can use accounts that are enabled for Unity Catalog to manage users and their access to data centrally across all of the workspaces in the account.

    For this level, you need to enter your account Id in the **{pageTitle} Account Id** text box.

  * **WorkspaceLevel (default):** In {pageTitle}, a workspace is a {pageTitle} deployment in the cloud that functions as an environment for your team to access {pageTitle} assets.

    No other settings are necessary for this level.

### Azure Service Principal

To connect with an Azure service principal, set the following properties:

* **Auth Scheme:** Select **AzureServicePrincipal**.
* **Azure Tenant Id:** Enter the tenant Id for your Microsoft Azure Active Directory application.
* **Azure Client Id:** Enter the client Id for your Microsoft Azure Active Directory application.
* **Azure Client Secret:** Enter the client secret for your Microsoft Azure Active Directory application.

### Azure Active Directory

To connect with an Azure Active Directory user account, set the following properties:

* **Auth Scheme:** Select **AzureAD**.
* **Azure Tenant:** Enter the Microsoft Online tenant that you use to access data. If you do not specify a tenant, {siteNameShort} uses the default tenant.
* **OAuth Client Id:** Enter the client Id that you were assigned when you registered your application with an OAuth authorization server.

## Complete Your Connection

To complete your connection:

1. (Optional) For **Database**, enter the name of your {pageTitle} database.
2. Define advanced connection settings on the **Advanced** tab. (In most cases, though, you should not need these settings.)
3. {oauthschemes ? `If you authenticate with ${oauthschemes}, click` : "Click"} **Connect to {datasource}** to connect to your {pageTitle} account.
4. Click **Create & Test** to create your connection.

## More Information

<CommonDatasourceMoreInformation datasource={datasource} advancedurl={advancedurl} siteName={siteName} driverVersion={driverVersion} />