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

Databricks Excel アドインの設定

Databricks Excel アドインは、Databricks ワークスペースを Microsoft Excel に接続し、ガバナンスされた Lakehouse データをスプレッドシートに直接取り込みます。このアドインは、Windows および macOS の両方の Excel for the web およびデスクトップ版で完全にサポートされています。

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

前提条件​

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

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

  • ワークスペース管理者が Excel Connector プレビューを有効にしていることを確認します。See Manage Databricks previews.

  • Excel が接続する各ワークスペースの Databricks ワークスペース URL。

  • Databricks SQL アクセス権を持ち、SQL Warehouse に対して少なくとも CAN USE 権限を持っていること。

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

  • 次のいずれかのバージョンのExcel：

    • Mac での Excel 2019 以降
    • Windows上のExcel (Microsoft 365)
    • Web上のExcel
    • Mac上のExcel (Microsoft 365)

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

  • Microsoft Entraテナントがサードパーティ製アプリに対するユーザーの同意をブロックしている場合、ユーザーがアカウントピッカーでサインインできるようにするには、Microsoft Entra管理者がDatabricksのSingle Sign Onエンタープライズアプリケーションに対して管理者同意を付与する必要があります。ユーザーがワークスペースのURLを直接入力してサインインする場合は、これは必要ありません。ログイン時の「Need admin approval」メッセージを参照してください。

アドインファイルのセットアップ​

注記

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

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

Databricks Excel アドインを使用するには、アドインファイルをDownloadして設定します。1つのアドインファイルで複数の Databricks ワークスペースに接続できます。

  1. Databricks Excel アドイン ファイルを download します。

Excel アドインファイルをDownloadする

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

    カスタム URL でサインインするには、次の例に示すように、カスタム URL と関連するワークスペース URL の両方を別々の <AppDomain> エントリとして追加します。サインインはどちらの URL にもリダイレクトできます。

    XML
    <AppDomains>
       
       <AppDomain>https://www.databricks.com</AppDomain>
       <AppDomain>https://login.databricks.com</AppDomain>
       
       
       <AppDomain>https://<instance1-id>.<region>.gcp.databricks.com</AppDomain>
       <AppDomain>https://<instance2-id>.<region>.gcp.databricks.com</AppDomain>
       
       <AppDomain>https://<custom-url>.databricks.com</AppDomain>
    </AppDomains>
注記

書式を設定せずに、プレーンテキストとしてワークスペース URL を貼り付けます。ほとんどのテキストエディタでは、Ctrl+Shift+V (Windows) または Command+Shift+V (macOS) を使用します。

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

オプション 1: Microsoft 365 管理センターからデプロイする​

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

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

Microsoft 365 管理センターにはこちらからアクセスできます。

注記

Databricks では、Databricks Excel アドインをカスタムアプリとしてデプロイすることを推奨しています。

カスタムマニフェストファイルを使用してアドインをデプロイします。前提条件で提供されているアドインファイルをdownloadしてセットアップします。

  1. Microsoft 365 管理センターで、 Settings > Integrated apps に移動し、 Link リンクをクリックします。
  2. 「 アドインの展開 」をクリックし、「 次へ 」をクリックします。
  3. 新しいアドインをデプロイするためのオプションとして、 Upload custom apps をクリックします。
  4. マニフェストを upload するオプションを選択します。 [ファイルを選択] をクリックし、アドインファイルをuploadします。
  5. アドインへのアクセスを許可するユーザーを選択します。
  6. デプロイ をクリックします。

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

注記

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

オプション2：個別ユーザーとしてデプロイする​

インストールステップは、Excel プラットフォームによって異なります。前提条件で提供されているアドインファイルをdownloadしてセットアップします。

Excel for the web で Excel アドインをインストールして接続するには、次の操作を行います。

  1. Web 版の Excel を開き、ワークブックを作成または開きます。
  2. [Home] tabで、 Add-ins > Advanced をクリックします。
  3. [Upload My Add-in] をクリックします。
  4. アドインファイルをuploadします。
  5. Upload をクリックします。
  6. [アドイン] メニューから Databricks アドインを見つけてクリックします。
  7. Databricks アカウントにサインインします。エラーが発生した場合は、ポップアップダイアログが有効になっていることを確認してください。
  8. 複数のワークスペース URL を構成した場合は、目的の Databricks アカウント名を選択します。URL が同じアカウント内にある場合のみ、特定のワークスペースを選択する必要があります。アカウント情報の詳細については、アカウント ID を確認するを参照してください。

アドインへのサインイン​

組織内の管理者が Databricks Excel アドインをデプロイしている場合は、Excel からサインインして Databricks ワークスペースに接続します。

  1. Excel で [ホーム] tab の下にある [Databricks アドイン] をクリックします。

  2. 初めてサインインするときは、次のいずれかのオプションを使用してワークスペースに接続します。

    • ワークスペースの URL の入力 (推奨) : Databricks ワークスペースの URL を入力します。このオプションを使用すると、ワークスペースの SSO でサインインできます。カスタム URL でサインインするには、カスタム URL と関連するワークスペースの URL の両方がアドインファイルに追加されていることを確認してください。アドインファイルのセットアップを参照してください。
    • [アカウント ピッカーの使用] : [アカウント ピッカーの選択] をクリックして login.databricks.com を開き、許可リストに登録されているアカウントとワークスペースを選択します。

  3. [サインイン] をクリックし、認証プロセスを完了して Databricks Excel アドインへのアクセス権を取得します。

最初のサインイン後、アドインはワークスペースを記憶します。2回目以降のサインインでは、ドロップダウンメニューからワークスペースを選択するか、上記のいずれかのオプションを使用して別のワークスペースに接続します。

Microsoft Entra ID 認証を使用しており、「Need admin approval」メッセージが表示される場合は、サインインする前に Microsoft Entra 管理者が Databricks エンタープライズ アプリケーションを承認する必要があります。See "Need admin approval" message on log in.

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

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

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

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

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

ログイン時の「Authentication in progress」メッセージ​

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

ログイン時の "Need admin approval" メッセージ​

Microsoft Entra テナントが Databricks アプリケーションに対するユーザーの同意をブロックしているため、Excel アドインから Databricks ワークスペースにログインすると、次の "Need admin approval" メッセージが表示されます。これはアカウントピッカー（login.databricks.com）を使用してサインインした場合のみ適用されます。これを回避するには、サインイン時にワークスペースのURLを直接入力してください。管理者の同意が与えられていない場合、直接のワークスペース アクセス権限を持っている場合でも、Microsoft Entra ID はログイン フローのブロックを継続します。

Excel アドインでの管理者承認メッセージが必要です

これを解決するには、適切な管理者ロールを持つ Microsoft Entra ユーザーが、Databricks エンタープライズ アプリケーションに対してテナント全体の管理者同意を付与する必要があります。

Microsoft Entra管理者に次のLinkにアクセスするよう依頼してください。{TENANT_ID} をMicrosoft EntraテナントIDに置き換えます：

Text
https://login.microsoftonline.com/{TENANT_ID}/adminconsent?client_id=aaec40b0-c0ae-4211-a98b-6fc160abb71b

Linkが機能しない場合は、管理者が手動で同意を付与できます。

  1. Microsoft Entra 管理センターで、[ Entra ID ] > [ エンタープライズ アプリケーション ] > [ すべてのアプリケーション ] に移動し、Single Sign Onに使用されている Databricks エンタープライズ アプリケーションを検索します。アプリケーションを特定するには、アプリケーション ID aaec40b0-c0ae-4211-a98b-6fc160abb71b を検索します。
  2. Databricks エンタープライズ アプリケーションによって要求された権限に対して管理者同意を付与します。
    1. [セキュリティ] の下にある [アクセス許可] をクリックします。
    2. 管理者同意の付与 をクリックします。

詳細な手順については、Microsoft のドキュメントを参照してください。

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

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

  • Excel for the web ：シートを再起動するか、ワークスペースを変更して、同じワークスペースに再度ログインします。See Change Databricks ワークスペース.
  • Excel デスクトップ : 右上隅にある情報アイコンをクリックし、[ 再読み込み ] を選択してアドインを再読み込みします。

次のステップ​

このページの見出し