> ## 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 CommonDatasourceAuthenticate = () => {
  return <p>コネクタを追加したら、必要なプロパティを設定します。</p>;
};

export const CommonDatasourceCompleteConnectionOauth = ({datasource = "the data source", title = "the connector", oauthschemes = "", start = 2}) => {
  return <ol start={start}>
      <li><strong>Advanced</strong> タブで詳細な接続設定を定義します。（ただし、ほとんどの場合、これらの設定は不要です。）</li>
      <li>{oauthschemes ? <>{oauthschemes} で認証する場合は、</> : <></>}<strong>{datasource} への接続</strong>をクリックして {title} アカウントに接続します。</li>
      <li><strong>作成およびテスト</strong>をクリックして接続を作成します。</li>
    </ol>;
};

export const CommonDatasourceMoreInformation = ({datasource = "the data source", advancedurl = "", siteName = "CData Sync", driverVersion = ""}) => {
  return <>
      <p>
        {siteName} と{datasource} の連携について、詳しくは{' '}
        <a href={`https://cdn.cdata.com/help/${advancedurl}${driverVersion}/jp/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>
        {siteNameShort} で{datasource} のデータを使用できるようにするには、まず以下の手順でコネクタを追加する必要があります：
      </p>
      <ol>
        <li>{siteNameShort} のダッシュボードから<strong>接続</strong>ページを開きます。</li>
        <li><strong>接続を追加</strong>をクリックして<strong>コネクタを選択</strong>ページを開きます。</li>
        <li>
          <strong>{destination ? "同期先" : "データソース"}</strong>タブをクリックして
          <strong>{title}</strong> 行に移動します。
        </li>
        <li>
          行末にある<strong>接続を設定</strong>アイコンをクリックして、<strong>新しい接続</strong>ページを開きます。この操作により、{' '}
          <strong>接続を追加</strong>ダイアログボックスが開きます。
          <br />
          <strong>Note：</strong> <strong>接続を設定</strong>アイコンが表示されない場合は、<strong>コネクタをダウンロード</strong>アイコンをクリックして {title} コネクタをインストールしてください。
        </li>
        <li><strong>接続を追加</strong>ダイアログボックスに接続名を入力します。</li>
        <li><strong>追加</strong>をクリックして、コネクタの<strong>設定</strong>タブを開きます。</li>
      </ol>
      <p>
        新しいコネクタのインストールについての詳細は、{' '}
        <a href="../connections">接続</a>を参照してください。
      </p>
    </>;
};

export const CommonDatasourceIntroDestination = ({datasource = "the data source", siteName = "CData Sync"}) => {
  return <p>
      {siteName} アプリケーションから{datasource} コネクタを使用して、サポートされている任意のデータソースから同期先の{datasource} へデータを移動できます。これを行うには、コネクタを追加し、コネクタへの認証を行い、接続を完了する必要があります。
    </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 = "";
export const oauthschemes = "AzureAD";

<CommonDatasourceIntroDestination datasource="Databricks" siteName={siteName} />

## Databricks でサポートされている機能

<p>{siteNameShort} の {datasource} 同期先は、以下の機能をサポートしており、最新の {datasource} 環境との連携が可能です。</p>

<ul>
  <li><a href="https://www.databricks.com/jp/product/unity-catalog" target="_blank" rel="noopener noreferrer">Unity Catalog</a>：カタログ、スキーマ、テーブルを含む {datasource} データアセットの一元的なガバナンスを提供します。</li>
  <li><a href="https://docs.databricks.com/aws/ja/delta" target="_blank" rel="noopener noreferrer">Delta Lake</a>：分析ワークロード向けに信頼性が高くパフォーマンスに優れたストレージを提供します。</li>
  <li><a href="https://docs.databricks.com/aws/ja/tables/managed" target="_blank" rel="noopener noreferrer">Delta テーブル</a>：Delta Lake 形式でデータを格納し、Unity Catalog を通じて管理できるテーブルです。</li>
</ul>

<Note>Delta テーブルにデータを読み込む際、{siteNameShort} は、{datasource} のネイティブ機能を活用した COPY INTO コマンドを使用して、ステージングされたデータを効率的に読み込みます。詳細については、Databricks Web サイトの <a href="https://docs.databricks.com/ja/ingestion/copy-into/index.html" target="_blank" rel="noopener noreferrer">COPY INTOを使用してデータをロードする</a> を参照してください。</Note>

## Databricks コネクタを追加

<CommonDatasourceAddConnector datasource="Databricks" title="Databricks" destination={true} siteNameShort={siteNameShort} />

## Databricks への認証

<CommonDatasourceAuthenticate datasource="Databricks" title="Databricks" destination={true} siteNameShort={siteNameShort} />

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

{siteName} supports authenticating to Databricks 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 Databricks server.

  To obtain your token:

  1. In your Azure Databricks 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 Databricks account.
* **Token:** Enter the token that you use to authenticate to your Databricks 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 Databricks 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 **Databricks Account Id** text box.

  * **WorkspaceLevel (default):** In Databricks, a workspace is a Databricks deployment in the cloud that functions as an environment for your team to access Databricks 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 Databricks 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 **Databricks Account Id** text box.

  * **WorkspaceLevel (default):** In Databricks, a workspace is a Databricks deployment in the cloud that functions as an environment for your team to access Databricks 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.

## 接続を完了する

To complete your connection:

1. (Optional) For **Database**, enter the name of your Databricks database.

<div style={{marginTop: "-1rem"}}>
  <CommonDatasourceCompleteConnectionOauth datasource={datasource} title={pageTitle} oauthschemes={oauthschemes} />
</div>

## 詳細について

<CommonDatasourceMoreInformation datasource="Databricks" advancedurl="LK" siteName={siteName} driverVersion={driverVersion} />