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 を許可リストに登録します。
アドインファイルを設定する
アドイン ファイルは、Excel に Databricks に安全に接続する方法を正確に指示する小さなコネクタ ファイルです。これは、Excel を開くたびにアドインが正しく読み込まれ、最新の状態に保たれることを保証するデジタル ハンドシェイクとして機能します。
Databricks Excel アドインを使用するには、アドイン ファイルをダウンロードして設定する必要があります。
-
次のリンクをクリックしてアドイン ファイルを開きます。
-
ページを
.xmlファイルとしてローカル マシンに保存します。ほとんどのブラウザでは、ページを右クリックして 「名前を付けて保存」 を選択するか、Ctrl+S(Windows) またはCommand+S(macOS) を押します。 -
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) を使用します。
- 変更を保存します。ファイルが
.xmlファイルとして適切にフォーマットされていることを確認してください。
オプション1: 管理者管理
グローバル管理者は、Databricks Excel アドインをダウンロードして構成し、組織内の他のユーザーに展開できます。前提条件で提供されているアドイン ファイルをダウンロードして設定します。
Databricks Excel アドインを Microsoft 365 管理者としてインストールするには、 global admin権限が必要です。管理者は、組織内のどのユーザーがアドインを使用できるかを決定できます。Microsoft 365 のグローバル管理者の詳細については、 Microsoft のドキュメントを参照してください。
- Microsoft 365 管理センターで、 [設定] > [統合アプリ] に移動し、 [アドイン] リンクをクリックします。
- [アドインの展開] をクリックし、 [次へ] をクリックします。
- 新しいアドインを展開するためのオプションとして、 カスタム アプリのアップロードを 選択します。
- マニフェストをアップロードするオプションを選択します。 [ファイルの選択] をクリックして、アドイン ファイルをアップロードします。
- アドインにアクセスできるユーザーを選択します。
- [デプロイ] をクリックします。
Databricks Excelアドインのアップロードに関する詳細なステップについては、 Microsoftドキュメントを参照してください。
管理者は、ワークスペースに関連付けられたアカウント名を、Databricks Excel アドインを使用しているユーザーと共有します。
オプション2: セルフサービス
インストール手順はExcelプラットフォームによって異なります。 前提条件で提供されているアドイン ファイルをダウンロードして設定します。
- Excel for the web
- Excel Desktop (Windows)
- Excel Desktop (macOS)
Web 用 Excel に Excel アドインをインストールして接続するには、次の手順を実行します。
- Web 用 Excel を開き、ブックを作成するか開きます。
- [ホーム] タブで、 [アドイン] > [詳細設定] をクリックします。
- [アドインのアップロード] を クリックします。
- アドイン ファイルをアップロードします。
- 「アップロード」 をクリックします。
- [アドイン] メニューから Databricks アドインを見つけてクリックします。
- Databricks アカウントにサインインします。エラーがある場合は、ポップアップ ダイアログを有効にしてください。
- 複数のワークスペース URL を構成した場合は、目的の Databricks アカウント名を選択します。URL が同じアカウント内にある場合は、特定のワークスペースを選択するだけで済みます。アカウント名の詳細については、 「アカウント ID を見つける」を参照してください。
Windows 用 Excel デスクトップに Excel アドインをインストールするには、次の手順を実行します。
-
ローカル ドライブに
Manifestという名前のフォルダーを作成します (例:C:\Manifest)。 -
アドイン ファイルを
C:\Manifestフォルダーにコピーします。 -
フォルダーのプロパティを開き、フォルダーを共有します。
Manifestフォルダを右クリックし、 [プロパティ] を選択します。- [共有] > [共有] をクリックし、読み取りおよび書き込み権限を持つユーザーとして自分自身を追加します。
-
Excel デスクトップを開きます。
-
マニフェスト フォルダーを信頼するように Excel を構成します。
- [ファイル] > [オプション] > [セキュリティ センター] > [セキュリティ センターの設定] をクリックします。
- サイドバーで、 [信頼できるアドイン カタログ] をクリックします。
- 「カタログ URL」 に、アドイン ファイルが保存されている共有フォルダーへのパスを入力します (例:
\\YourComputerName\Manifest)。 - [カタログの追加] をクリックします。
- メニューに表示 チェックボックスを選択します。
- 「OK」 をクリックして変更を保存します。
-
Excel デスクトップを再起動します。
-
[アドイン] > [その他のアドイン] > [共有フォルダー] をクリックします。
-
Databricks コネクタを選択し、 [追加] をクリックします。
-
Databricks アドインをクリックし、Databricks アカウントへのサインイン プロセスを完了します。
-
複数のワークスペース URL を構成した場合は、目的の Databricks アカウント名を選択します。URL が同じアカウント内にある場合は、特定のワークスペースを選択するだけで済みます。アカウント名の詳細については、 「アカウント ID を見つける」を参照してください。
macOS 用 Excel デスクトップに Excel アドインをインストールするには、次の手順を実行します。
-
Microsoft Office アドイン フォルダーを見つけます。デフォルトでは、ディレクトリは次のようになります。
/Users/<your-username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef -
アドイン ファイルをこのフォルダーにコピーします。
-
Excel デスクトップを開くか再起動します。
-
ナビゲーション バーで、 [アドイン] > [個人用アドイン] をクリックします。
-
Databricks アドインをクリックします。
-
Databricks アカウントへのサインイン プロセスを完了します。
-
複数のワークスペース URL を構成した場合は、目的の Databricks アカウント名を選択します。URL が同じアカウント内にある場合は、特定のワークスペースを選択するだけで済みます。アカウント名の詳細については、 「アカウント ID を見つける」を参照してください。
Databricksワークスペースの変更
アドイン ファイルで複数の Databricks ワークスペースが指定されている場合は、それらのワークスペースを切り替えることができます。詳細については、 「アドイン ファイルの設定」を参照してください。
別の Databricks ワークスペースに接続するには、次の手順を実行します。
- Databricksアドイン ウィンドウの右上で、コンピュート セレクターの横にある 3 点メニューをクリックします。
- [ワークスペースの変更] をクリックします。
- ワークスペースが含まれているアカウントを選択し、プロンプトが表示されたらワークスペースを選択してサインインします。
「認証中」のトラブルシューティング
アドインから Databricks にログインしようとしたときに「認証中」ウィンドウが表示される場合は、ワークスペースがカスタム アドイン ファイルに正しく追加されていない可能性があります。<AppDomains>でワークスペースが正しく構成されていることを確認してください。