> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-bradley-turek-pfilter-operators-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# DomoのDatabricks（推奨）

## はじめに

Cloud Integrationsでは、Databricksを使用してDomoインスタンスを稼働させることができます。このガイドは、Databricksに精通しているユーザーを対象としており、読み取り専用および読み取り/書き込み統合のためにDatabricksをCloud Integrationsに登録する方法について説明しています。

選択した設定プロセスが完了したら、Databricksから読み込まれた仮想テーブルを使用して、カードを作成したり、アラートを設定したり、Magic ETL DataFlowで入力として使用したりすることが可能になります。

## 構造的な概要

以下の図は、DomoがCloud Integrationsを介してDatabricksに接続する仕組みを示しています。Domoはお客様のDatabricks環境からデータをライブでクエリし、Domoのストレージにデータをコピーすることはありません。

<Frame>
  <img alt="databricks architectural overview.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000002joPJ.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=ace90266b4bfb5c519c30bb4964780b1" width="2000" height="1714" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000002joPJ.jpg" />
</Frame>

## 必要条件

Databricks接続を設定する前に、次の手順を完了することを強く推奨します。

* **（推奨）Databricksサービスアカウントを作成する —**
  この統合専用の新しいDatabricksアカウントを作成することを推奨します。Databricksでは、読み取りアクセス権を持つ任意のアカウントを使用できますが、サービスアカウントを使用するのがベストプラクティスです。DomoでDatabricks仮想テーブルを作成するには、このアカウントにデフォルトのDatabricks環境への読み取りアクセス権が必要です。
* **（推奨）Domoサービスアカウントを作成する —**
  この統合専用の新しいDomoアカウントを作成することを推奨します。アカウントのカスタマイズされた権限で、「クラウドアカウントを管理」および「DataSetを管理」の許可が有効になっている必要があります。Databricks-Cloud Integrations接続でのOAuthの使用の詳細については、「 [個人用アクセストークンを使用するDatabricks](/ja/s/article/000005522) 」を参照してください。

権限と許可の詳細については、「 [カスタマイズされた権限を管理する](/ja/s/article/360043438973) 」を参照してください。

## 読み取り専用設定

Cloud Integrationsを使用してDomo内からDatabricksテーブルへの読み取り専用アクセス権を設定するには、次の手順に従います。

1. Domoサービスアカウントにログインします。

2. <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004mhMv.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=dbbf2f2e7bdda8fca6bac743434720de" style={{width: 20, height: 20, display: 'inline', verticalAlign: 'start', margin: '0'}} width="44" height="44" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004mhMv.jpg" /> **［Data Warehouse］** に進みます。

3. **<img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BCKP-00N5w00000Ri7BU-0EM5w000005vNtv.png?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=89ef26a8dad84f3e03b171a52e096e6a" style={{width: 20, height: 20, display: 'inline', verticalAlign: 'start', margin: '0'}} width="100" height="110" data-path="images/kb/ka0Vq000000BCKP-00N5w00000Ri7BU-0EM5w000005vNtv.png" />** **［新しいクラウドアカウントを追加］** を選択します。

   ［新しい統合］モーダルが表示されます。

4. モーダルの **［ネイティブ統合］** で、 **［Databricks］** を選択します（Databricksが表示されない場合は **［詳細を見る］** を選択して可能なすべての統合を表示します）。

   <Frame>
     <img alt="choose databricks.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq0000053Y8j.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=075eea587d166c0d3c60789f28c82079" width="2120" height="1414" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq0000053Y8j.jpg" />
   </Frame>

5. **［+新しい統合を追加］** を選択します。既存の統合がほかにある場合、このオプションはリストの一番下に表示されます。

   <Frame>
     <img alt="add new integration.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EM5w000006vuAS.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=0d7808cb0e909d7682d9bdbf3618839b" width="1722" height="1196" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EM5w000006vuAS.jpg" />
   </Frame>

6. モーダルのフィールドに入力します。各画面で **［次へ］** を選択すると、モーダルを移動できます
   1. **［統合名］** および **［統合の説明］** フィールドに名前とオプションの説明を入力します。

   2. Databricksアカウントで個人用アクセストークンを作成します。*ページを離れた後ではトークンを回復できないため、レコードのトークンをコピーします。*

   3. 統合モーダルの **［Databricksの個人用アクセストークン］** フィールドにトークンをペーストします。

   4. DatabricksでDatabricks接続URLを見つけます。（Databricksで **［SQL Warehouses］** >｛ *ウェアハウス名* ｝> **［Connection details］** に進みます）。

      <Note>
        **注記：** URLにプロトコル識別子を含めないでください。例えば「 **jdbc:databricks\://** 」は適切で、「 **jdbc:spark://** 」はサポートされていません。
      </Note>

   5. JDBC URLをコピーし、統合モーダルの **［Databricks接続URL］** フィールドに貼り付けます。

      <Frame>
        <img alt="Screenshot 2024-10-10 at 10.45.07 AM.png" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000003AnCE.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=3258d50d5dc8fc35e40145d49b555c66" width="1139" height="690" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000003AnCE.jpg" />
      </Frame>

7. データの鮮度設定を行います。データの鮮度に関するスケジュールの詳細設定については、[こちら](/ja/s/article/4412849158167) を参照してください。

これで設定が完了しました。必要に応じてDatabricksテーブルを選択してDomoに接続するには、以下の手順に従います。

### DomoにDatabricksテーブルを追加する

次のプロセスはオプションです。

1. 読み取り専用統合を設定したら、**［Choose Tables to Connect］** を選択します。

   <Frame>
     <img alt="choose tables.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EM5w000006vuAr.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=37a645f14ae169f25f27d7a6433cd7c1" width="1716" height="1190" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EM5w000006vuAr.jpg" />
   </Frame>

2. DomoでDataSetを作成するのに使用するDatabricksスキーマとテーブルを検索して選択します。

3. **［DataSetを作成］** を選択します。

   <Frame>
     <img alt="schemas and tables.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EM5w000006vuAw.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=ff88e2f78fe2c8ca675b613d2857aafe" width="1788" height="1182" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EM5w000006vuAw.jpg" />
   </Frame>

DatabricksからCloud Integrationsへの読み取り専用統合の設定が完了しました。

## 書き込み設定

このセクションの手順を進める前に、以下の必要条件を満たしてください。

### 必要条件

* DatabricksインスタンスでUnity Catalogを有効にします。有効化の手順については、[こちら](https://docs.databricks.com/aws/ja/data-governance/unity-catalog/enable-workspaces#enable-your-workspace-for-unity-catalog) を参照してください <i className="icon-arrow-square-out sm" aria-hidden="true" /> 。
* 以下のDatabricksユーザーのDatabricks権限を取得します。
  * ストレージ認証情報を作成
  * カタログを作成
  * 外部ロケーションを作成

### 読み取り専用統合を読み取り/書き込み統合に変換する

1. Domoインスタンスで <img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004mhMv.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=dbbf2f2e7bdda8fca6bac743434720de" style={{width: 20, height: 20, display: 'inline', verticalAlign: 'start', margin: '0'}} width="44" height="44" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004mhMv.jpg" /> **［Data Warehouse］** に移動し、 **［クラウド接続を管理］** を選択して統合モーダルを開きます。

   <Frame>
     <img alt="manage cloud connections databricks.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004pxTZ.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=52e43c0d7ca79d7f738c611775118f63" width="2120" height="866" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004pxTZ.jpg" />
   </Frame>

2. モーダルの **［ネイティブ統合］** で、 **［詳細を見る］** > **［Databricks］** を選択します。

   既存のDatabricks統合のリストが表示されます。

3. 読み取り/書き込み統合にアップグレードする既存の読み取り専用統合を見つけます。統合行にカーソルを合わせて、<img src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004riF7.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=54f71818a51b61ddd7946aa8bab79f8b" style={{width: 20, height: 20, display: 'inline', verticalAlign: 'start', margin: '0'}} width="36" height="34" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004riF7.jpg" /> **［オプション］** （レンチアイコン）> **［書き込みアクセスを設定］** を選択します。

   各手順を完了するごとに **［次へ］** を使用してモーダルを移動します。

   <Frame>
     <img alt="configure write access.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004rj9Z.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=b4f6f7ea74737b4472bccba170649f3c" width="2512" height="1600" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004rj9Z.jpg" />
   </Frame>

4. モーダルで、ラベル付きフィールドにDatabricksの書き込みカタログ名を入力します。

   <Frame>
     <img alt="enter catalog name.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq0000050paj.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=11e8ecfbd56197f2ff38fddb2f81973f" width="3040" height="1588" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq0000050paj.jpg" />
   </Frame>

5. **［検証］** を選択してカタログ名を確認し、そのカタログに属するスキーマのリストを読み込みます。

   <Frame>
     <img alt="validate catalog.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq00000543Z8.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=2267598abd7c69a90658be3390921a5b" width="3034" height="1596" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq00000543Z8.jpg" />
   </Frame>

6. カタログを検証した後、**［スキーマ］** ドロップダウンからスキーマを選択します 。

   <Frame>
     <img alt="choose schema.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq00000540Ze.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=6eaf08b890ac12ac82fec95c018554e5" width="3024" height="1598" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq00000540Ze.jpg" />
   </Frame>

7. 画面上の指示に従ってストレージ認証情報を作成し、**［STORAGE\_AWS\_EXTERNAL\_ID］** フィールドに入力します。

   <Frame>
     <img alt="new storage credential.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq0000050pvh.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=31127b3053ff9187e553ebd3cb343411" width="3034" height="1592" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq0000050pvh.jpg" />
   </Frame>

8. 画面上の指示に従って、**外部ロケーション** を作成します。

   <Frame>
     <img alt="create external locations.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004pr1a.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=1ba3eb31df3bc6296214647e4ee445ee" width="1878" height="1184" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004pr1a.jpg" />
   </Frame>

9. **［書き込み統合を確定する］** の画面上で、DomoがDatabricks環境に変更を加えられることを理解していることを確認します。

   <Frame>
     <img alt="finalize write integration.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004q4Jl.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=177868739afa6496c6a7bd51921d8bae" width="1826" height="1168" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004q4Jl.jpg" />
   </Frame>

   成功メッセージが表示されます。

10. **［アカウントのリストに戻る］** を選択して、読み取りと書き込みのアクセスが設定された統合を表示します。

    <Frame>
      <img alt="read and write access.jpg" src="https://mintcdn.com/domoinc-bradley-turek-pfilter-operators-reference/Ylyst5VnP7UsFQlt/images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004q4Zt.jpg?fit=max&auto=format&n=Ylyst5VnP7UsFQlt&q=85&s=4c717b2437d74d1fa6f5ae86034d98bd" width="1800" height="1140" data-path="images/kb/ka0Vq000000BENp-00N5w00000Ri7BU-0EMVq000004q4Zt.jpg" />
    </Frame>

Magic ETL DataFlowの出力をDatabricksに書き戻すなど、Domo全体で書き込み統合を使用できるようになりました。

## Databricksから供給されたDataSet

Databricksから供給されたDataSetをDataFlowで使用すると、フローの開始時にDatabricksがそのデータをライブでクエリします。また、Databricksから供給されたDataSetは、テーブルの LAST\_ALTERED の日時にもとづいて15分ごとに更新がチェックされます。最後にチェックした後にテーブルが更新された場合、このテーブルをトリガーとして使用するDataFlowが開始されます。
