メインコンテンツまでスキップ
に最終更新

Databricks Excelアドインを設定する

備考

プレビュー

この機能は パブリック プレビュー段階です。

Databricks Excelアドインは、 DatabricksワークスペースをMicrosoft Excelに接続し、管理されたレイクハウス データをスプレッドシートに直接取り込み、データから意思決定までより迅速に移行できるようにします。 このアドインは、Windows と macOS の両方の Web 版およびデスクトップ版の Excel で完全にサポートされています。

このページでは、Microsoft Excel で Databricks Excel アドインを設定するために使用できる 2 つの方法について説明します。このアドインは、シングル サインオン ( SSO ) 認証を使用してDatabricksワークスペースに接続し、データガバナンスのUnity Catalogとアクセス制御をサポートします。

前提条件​

Excel アドインをインストールする前に、次のものがあることを確認してください。

  • Unity Catalog が有効になっている Databricks ワークスペースへのアクセス。

  • 実行中のSQLウェアハウスへのアクセス。

  • ワークスペース内の Unity Catalog テーブルからデータを読み取る権限。

  • 次のいずれかのバージョンの Excel を使用しています。

    • Mac 版 Excel 2019 以降
    • Windows 版 Excel (Microsoft 365)
    • ウェブ上のExcel
    • Mac 上の Excel (Microsoft 365)

  • ファイアウォールまたはクラウド セキュリティ プラットフォームを使用する場合は、アドイン ファイルに含まれる Databricks ワークスペースの URL を許可リストに登録します。

アドインファイルを設定する​

注記

Microsoft Marketplace を通じてアドインをデプロイする管理者の方は、このセクションをスキップしてください。Marketplace 展開では、アドイン ファイルの代わりにPowerShellを使用してワークスペース アクセスを構成します。 Microsoft Marketplace 経由でのデプロイを参照してください。

アドイン ファイルは、Excel に Databricks に安全に接続する方法を正確に指示する小さなコネクタ ファイルです。これは、Excel を開くたびにアドインが正しく読み込まれ、最新の状態に保たれることを保証するデジタル ハンドシェイクとして機能します。

Databricks Excelアドインを使用するには、アドインファイルをダウンロードして設定してください。

  1. 次のリンクをクリックしてアドイン ファイルを開きます。

    Databricks Excel アドイン ファイル

  2. ページを.xmlファイルとしてローカル マシンに保存します。ほとんどのブラウザでは、ページを右クリックして 「名前を付けて保存」 を選択するか、 Ctrl+S (Windows) またはCommand+S (macOS) を押します。

  3. AppDomainsセクション内の<AppDomain>としてワークスペース URLを指定して、アドイン ファイルを編集します。ワークスペース URL は、ブラウザーで Databricks ワークスペースにアクセスするために使用するベース URL です。複数のDatabricksワークスペースを切り替えるには、各ワークスペースの URL をアドイン ファイルに追加します。

    XML
    <AppDomains>
       
       <AppDomain>https://www.databricks.com</AppDomain>
       <AppDomain>https://login.databricks.com</AppDomain>
       
       
       <AppDomain>https://<workspace1-id>.cloud.databricks.com</AppDomain>
       <AppDomain>https://<workspace2-id>.cloud.databricks.com</AppDomain>
    </AppDomains>
注記

ワークスペースの URL をフォーマットなしのプレーンテキストとして貼り付けます。ほとんどのテキスト エディターでは、 Ctrl+Shift+V (Windows) またはCommand+Shift+V (macOS) を使用します。

  1. 変更を保存します。ファイルが.xmlファイルとして適切にフォーマットされていることを確認してください。

オプション1: 管理者管理​

グローバル管理者として、組織内のユーザーにDatabricks Excelアドインを展開できます。アドインファイルを使用してカスタムアプリとしてアドインをデプロイするか、Microsoft Marketplaceからインストールすることができます。

Microsoft 365 管理者として Databricks Excel アドインをインストールするには、 global admin権限が必要です。管理者として、組織内のどのユーザーがアドインを使用できるかを決定できます。Microsoft 365 のグローバル管理者に関する詳細は、 Microsoft のドキュメントを参照してください。

カスタムマニフェストファイルを使用してアドインをデプロイします。前提条件に記載されているアドインファイルをダウンロードしてセットアップしてください。

  1. Microsoft 365 管理センターで、 [設定] > [統合アプリ] に移動し、 [アドイン] リンクをクリックします。
  2. [アドインの展開] をクリックし、 [次へ] をクリックします。
  3. 新しいアドインをデプロイするオプションとして、 「カスタムアプリをアップロード」を クリックしてください。
  4. マニフェストをアップロードするオプションを選択します。 [ファイルの選択] をクリックして、アドイン ファイルをアップロードします。
  5. アドインにアクセスできるユーザーを選択します。
  6. [デプロイ] をクリックします。

Databricks Excelアドインのアップロードに関する詳細なステップについては、 Microsoftドキュメントを参照してください。

注記

管理者として、許可リストに登録したワークスペースに関連付けられたアカウント名を、Databricks Excelアドインを使用する予定のユーザーと共有してください。アドインへのサインインを参照してください。

オプション2: セルフサービス​

インストール手順はExcelプラットフォームによって異なります。 前提条件で提供されているアドイン ファイルをダウンロードして設定します。

Web 用 Excel に Excel アドインをインストールして接続するには、次の手順を実行します。

  1. Web 用 Excel を開き、ブックを作成するか開きます。
  2. [ホーム] タブで、 [アドイン] > [詳細設定] をクリックします。
  3. [アドインのアップロード] を クリックします。
  4. アドイン ファイルをアップロードします。
  5. 「アップロード」 をクリックします。
  6. [アドイン] メニューから Databricks アドインを見つけてクリックします。
  7. Databricks アカウントにサインインします。エラーがある場合は、ポップアップ ダイアログを有効にしてください。
  8. 複数のワークスペース URL を構成した場合は、目的の Databricks アカウント名を選択します。URL が同じアカウント内にある場合は、特定のワークスペースを選択するだけで済みます。アカウント名の詳細については、 「アカウント ID を見つける」を参照してください。

アドインにサインインする​

組織の管理者がDatabricks Excelアドインをデプロイしている場合は、サインインしてDatabricksに接続してください。 Excelから。

  1. Excel の [ホーム] タブで、Databricks アドインをクリックします。
  2. ワークスペースのURLを入力するか、ドロップダウンリストから以前使用したワークスペースのURLを選択してください。このアドインは、ユーザーまたは管理者によって設定されたワークスペースのURLを記憶します。
  3. [サインイン] を クリックして認証プロセスを完了すると、すべての Databricks Excel アドイン機能にアクセスできるようになります。

Databricksワークスペースの変更​

アドイン ファイルで複数の Databricks ワークスペースが指定されている場合は、それらのワークスペースを切り替えることができます。詳細については、 「アドイン ファイルの設定」を参照してください。

別の Databricks ワークスペースに接続するには、次の手順を実行します。

  1. Databricksアドイン ウィンドウの右上で、コンピュート セレクターの横にある 3 点メニューをクリックします。
  2. [ワークスペースの変更] をクリックします。
  3. ワークスペースが含まれているアカウントを選択し、プロンプトが表示されたらワークスペースを選択してサインインします。

トラブルシューティング​

ログイン時に「認証処理中」というメッセージが表示される​

アドインから Databricks にログインしようとしたときに「認証中」ウィンドウが表示される場合は、ワークスペースがカスタム アドイン ファイルに正しく追加されていない可能性があります。<AppDomains>でワークスペースが正しく構成されていることを確認してください。

リソースを使用できません​

DatabricksアドインでSQLウェアハウスなどのDatabricksリソースを使用できない場合は、使用しているExcelのバージョンに応じて次のいずれかの方法を試してください。

  • Web 用Excel : シートを再起動するか、ワークスペースを変更して同じワークスペースに再度ログインします。 「Change Databricksワークスペース」を参照してください。
  • Excel デスクトップ版 ：右上隅の情報アイコンをクリックし、 [再読み込み] を選択してアドインを再読み込みします。

次のステップ​