Einrichten des Azure Databricks Excel-Add-Ins

Das Azure Databricks Excel-Add-In verbindet Ihren Azure Databricks Arbeitsbereich mit Microsoft Excel, gesteuerte Lakehouse-Daten direkt in Ihre Tabellenkalkulationen zu bringen, damit Sie von Daten zu Entscheidungen schneller wechseln können. Das Add-In wird für Excel for the web und Desktopversionen sowohl für Windows als auch für macOS vollständig unterstützt.

Auf dieser Seite werden die beiden verfügbaren Methoden zum Einrichten des Azure Databricks Excel-Add-Ins in Microsoft Excel beschrieben. Dieses Add-In verwendet die SSO-Authentifizierung (Single Sign-On), um eine Verbindung mit Ihrem Azure Databricks Arbeitsbereich herzustellen und Unity Catalog für die Datengovernance und Zugriffssteuerung zu unterstützen.

Voraussetzungen

Stellen Sie vor der Installation des Excel-Add-Ins sicher, dass Sie über Folgendes verfügen:

• Zugriff auf einen Azure Databricks Arbeitsbereich mit aktiviertem Unity-Katalog.
• Ihre Azure Databricks workspace-URL für jeden Arbeitsbereich, mit dem Excel eine Verbindung herstellen sollte. Benutzerdefinierte Konto-URLs werden nicht unterstützt.
• Zugriff auf ein ausgeführtes SQL Warehouse.
• Berechtigungen zum Lesen von Daten aus Unity-Katalogtabellen in Ihrem Arbeitsbereich.
• Eine der folgenden Versionen von Excel:
  • Excel 2019 oder höher auf einem Mac
  • Excel auf Windows (Microsoft 365)
  • Excel im Web
  • Excel auf dem Mac (Microsoft 365)
• Wenn Sie eine Firewall oder eine Cloudsicherheitsplattform verwenden, lassen Sie die Azure Databricks Arbeitsbereich-URLs, die in der Add-In-Datei enthalten sind, auflisten.

Einrichten der Add-In-Datei

Die Add-In-Datei ist eine kleine Konnektordatei, die Excel genau angibt, wie eine sichere Verbindung mit Azure Databricks hergestellt werden kann. Es fungiert als digitaler Handshake, der sicherstellt, dass das Add-In ordnungsgemäß geladen wird und jedes Mal auf dem neuesten Stand bleibt, wenn Sie Excel öffnen.

Laden Sie die Add-In-Datei herunter, und richten Sie sie ein, um das Azure Databricks Excel-Add-In zu verwenden.

1. Öffnen Sie die Add-In-Datei, indem Sie auf den folgenden Link klicken:

   Azure Databricks Excel Add-In-Datei

2. Speichern Sie die Seite als .xml Datei auf Ihrem lokalen Computer. Klicken Sie in den meisten Browsern mit der rechten Maustaste auf die Seite, und wählen Sie Speichern als aus, oder drücken Sie Ctrl+S (Windows) oder Command+S (macOS).

3. Bearbeiten Sie die Add-In-Datei, indem Sie Ihre Arbeitsbereichs-URL als <AppDomain> im AppDomains Abschnitt angeben. Ihre Arbeitsbereichs-URL ist die Basis-URL, die Sie für den Zugriff auf Ihren Azure Databricks Arbeitsbereich in einem Browser verwenden. Um zwischen mehreren Azure Databricks-Arbeitsbereichen zu wechseln, fügen Sie die URL für jeden Arbeitsbereich zur Add-In-Datei hinzu.

   <AppDomains>
      <!-- DO NOT CHANGE -->
      <AppDomain>https://www.databricks.com</AppDomain>
      <AppDomain>https://login.databricks.com</AppDomain>
      <!-- ADD WORKSPACE URLS AS SHOWN BELOW; PUT EACH WORKSPACE URL IN ITS OWN <AppDomain> TAG  -->
      <!-- EXAMPLE -->
      // highlight-next-line
      <AppDomain>https://adb-<workspace1-id>.<random-number>.azuredatabricks.net</AppDomain>
      // highlight-next-line
      <AppDomain>https://adb-<workspace2-id>.<random-number>.azuredatabricks.net</AppDomain>
   </AppDomains>
   

   Hinweis

   Fügen Sie die Arbeitsbereichs-URL ohne Formatierung als Nur-Text ein. Verwenden Sie in den meisten Text-Editoren Ctrl+Shift+V (Windows) oder Command+Shift+V (macOS).

4. Speichern Sie Ihre Änderungen. Stellen Sie sicher, dass die Datei ordnungsgemäß als .xml Datei formatiert ist.

Option 1: Vom Administrator verwaltet

Als globaler Administrator können Sie das Azure Databricks Excel-Add-In für Benutzer in Ihrer Organisation bereitstellen. Sie können das Add-In als benutzerdefinierte App mithilfe der Add-In-Datei bereitstellen oder aus dem Microsoft Marketplace installieren.

Um das Azure Databricks Excel-Add-In als Microsoft 365 Admin zu installieren, benötigen Sie die Berechtigung global admin. Als Administrator können Sie festlegen, welche Benutzer in Ihrer Organisation Add-Ins verwenden können. Weitere Informationen zu globalen Administratoren in Microsoft 365 finden Sie in der dokumentation Microsoft.

Bereitstellen als benutzerdefinierte App

Stellen Sie das Add-In mithilfe einer benutzerdefinierten Manifestdatei bereit. Laden Sie die in den Voraussetzungen bereitgestellte Add-In-Datei herunter, und richten Sie sie ein.

1. Wechseln Sie im Microsoft 365 admin center zu Settings > Integrated apps und klicken Sie auf den Link Add-ins.
2. Klicken Sie auf "Add-In bereitstellen" , und klicken Sie auf "Weiter".
3. Klicken Sie auf "Benutzerdefinierte Apps hochladen ", um ein neues Add-In bereitzustellen.
4. Wählen Sie die Option zum Hochladen eines Manifests aus. Klicken Sie auf "Datei auswählen ", und laden Sie die Add-In-Datei hoch.
5. Wählen Sie aus, welche Benutzer Zugriff auf das Add-In haben sollen.
6. Klicken Sie auf "Bereitstellen".

Ausführliche Schritte zum Hochladen des Azure Databricks Excel-Add-Ins finden Sie in der dokumentation Microsoft.

Bereitstellen von Microsoft Marketplace

Installieren Sie das Add-In aus dem Microsoft Marketplace, und verwenden Sie PowerShell zum Konfigurieren des Arbeitsbereichzugriffs.

Voraussetzungen

• PowerShell ist auf Ihrem Computer installiert.
• Sie müssen Windows PowerShell als Administrator ausführen.

Installieren des Add-Ins

1. Wechseln Sie im Microsoft 365 admin center zu Settings > Integrated apps und klicken Sie auf den Link Get Apps.
2. Suchen Sie nach "Azure Databricks-Add-In für Excel".
3. Klicken Sie auf "Jetzt abrufen".
4. Stellen Sie das Add-In selbst bereit, indem Sie "Nur ich " unter " Benutzer zuweisen" auswählen.
5. Klicken Sie auf "Bereitstellen".

Ausführliche Schritte zum Bereitstellen des Azure Databricks Excel-Add-Ins aus dem Microsoft Marketplace finden Sie in der Dokumentation Microsoft.

Konfigurieren des Arbeitsbereichzugriffs

Verwenden Sie nach der Installation des Add-Ins PowerShell, um Ihre Azure Databricks Arbeitsbereich-URLs auf die Positivliste zu setzen.

1. Öffnen Sie PowerShell, und führen Sie sie als Administrator aus. Weitere Informationen finden Sie in der dokumentation Microsoft.

2. Installieren und Importieren des Office 365 zentralen Bereitstellungsmoduls:

   Install-Module -Name O365CentralizedAddInDeployment
   Import-Module O365CentralizedAddInDeployment
   

3. Stellen Sie eine Verbindung her, und melden Sie sich als Administrator bei Ihrem Office 365 Mandanten an:

   Connect-OrganizationAddInService
   

4. Vergewissern Sie sich, dass das Add-In bereitgestellt wurde. Das Azure Databricks-Add-In für Excel sollte in der Liste angezeigt werden.

   Get-OrganizationAddIn
   

   Wenn das Add-In nicht angezeigt wird, muss es möglicherweise erneut bereitgestellt werden oder befindet sich noch im Bereitstellungsprozess.

5. Allowlist Azure Databricks Arbeitsbereich-URLs. Ersetzen Sie jede <workspace-url> durch die URL eines Arbeitsbereichs, den Sie zulassen möchten. Sie können beliebig viele Arbeitsbereichs-URLs einschließen.

   Set-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052 `
     -AppDomains "https://adb-<workspace1-id>.<random-number>.azuredatabricks.net", "https://adb-<workspace2-id>.<random-number>.azuredatabricks.net"
   

   Die Produkt-ID für Azure Databricks ist d75dbea5-bf93-49b8-9a49-bdf4e9d6f052.

6. Bestätigen Sie die korrekte Zulassungsliste. Die freigegebenen Arbeitsbereich-URLs sollten im AppDomains Abschnitt angezeigt werden.

   Get-OrganizationAddInOverrides -ProductId d75dbea5-bf93-49b8-9a49-bdf4e9d6f052
   

Testen des Add-Ins

1. Suchen Sie in Excel das Azure Databricks-Add-In.
2. Melden Sie sich an, und stellen Sie eine Verbindung mit einem der Arbeitsbereiche her, die Sie zugelassen haben.

Bereitstellen in Ihrer Organisation

1. Wechseln Sie im Microsoft 365 admin center zu Settings > Integrated apps.
2. Wählen Sie das Azure Databricks Add-In aus, das Sie installiert und konfiguriert haben.
3. Klicken Sie auf die Registerkarte " Benutzer ", und wählen Sie aus, ob sie in Ihrer gesamten Organisation oder einer bestimmten Gruppe von Benutzern bereitgestellt werden sollen.

Option 2: Selbstbedienung

Die Installationsschritte variieren je nach Excel Plattform. Laden Sie die in den Voraussetzungen bereitgestellte Add-In-Datei herunter, und richten Sie sie ein.

Excel für das Web

Gehen Sie wie folgt vor, um das Excel-Add-In Excel for the web zu installieren und eine Verbindung mit dem Add-In herzustellen:

1. Öffnen Sie Excel for the web, und erstellen oder öffnen Sie eine Arbeitsmappe.
2. Klicken Sie auf der Registerkarte "Start" auf "Add-Ins>Erweitert".
3. Klicken Sie auf "Mein Add-In hochladen".
4. Laden Sie die Add-In-Datei hoch.
5. Klicken Sie auf Hochladen.
6. Suchen und klicken Sie im Menü Add-ins auf das Azure Databricks-Add-In.
7. Melden Sie sich bei Ihrem Azure Databricks Konto an. Wenn ein Fehler auftritt, stellen Sie sicher, dass Popupdialoge aktiviert werden.
8. Wenn Sie mehrere Arbeitsbereich-URLs konfiguriert haben, wählen Sie den gewünschten Azure Databricks Kontonamen aus. Sie müssen nur einen bestimmten Arbeitsbereich auswählen, wenn sich die URLs innerhalb desselben Kontos befinden. Weitere Informationen zu Kontonamen finden Sie unter Suchen Ihrer Konto-ID.

Excel Desktop (Windows)

Gehen Sie wie folgt vor, um das Excel-Add-In in Excel Desktop für Windows zu installieren:

1. Erstellen Sie einen Ordner mit dem Namen Manifest auf Ihrem lokalen Laufwerk (z. B C:\Manifest. ).
2. Kopieren Sie die Add-In-Datei in den C:\Manifest Ordner.
3. Öffnen Sie die Ordnereigenschaften, und geben Sie den Ordner frei:
   1. Klicken Sie mit der rechten Maustaste auf den Manifest Ordner, und wählen Sie "Eigenschaften" aus.
   2. Klicken Sie auf "Freigabe">"Teilen" und fügen Sie sich selbst als Benutzer mit Lese- und Schreibberechtigungen hinzu.
4. Öffnen Sie Excel Desktop.
5. Konfigurieren Sie Excel, um dem Manifestordner zu vertrauen:
   1. Klicken Sie auf Datei>Optionen>Vertrauensstellungscenter>Einstellungen für das Vertrauensstellungscenter.
   2. Klicken Sie in der Randleiste auf vertrauenswürdige Add-In-Kataloge.
   3. Geben Sie in der Katalog-URL den Pfad zum freigegebenen Ordner ein, in dem sich die Add-In-Datei befindet (z. B \\YourComputerName\Manifest. ).
   4. Klicken Sie auf "Katalog hinzufügen".
   5. Aktivieren Sie das Kontrollkästchen "Im Menü anzeigen ".
   6. Klicken Sie auf OK, um Ihre Änderungen zu speichern.
6. Starten Sie Excel Desktop neu.
7. Klicken Sie auf Add-Ins>Weitere Add-Ins>Freigegebener Ordner.
8. Wählen Sie den Azure Databricks Connector aus, und klicken Sie auf Add.
9. Klicken Sie auf das Azure Databricks-Add-In, und schließen Sie den Anmeldevorgang für Ihr Azure Databricks Konto ab.
10. Wenn Sie mehrere Arbeitsbereich-URLs konfiguriert haben, wählen Sie den gewünschten Azure Databricks Kontonamen aus. Sie müssen nur einen bestimmten Arbeitsbereich auswählen, wenn sich die URLs innerhalb desselben Kontos befinden. Weitere Informationen zu Kontonamen finden Sie unter Suchen Ihrer Konto-ID.

Excel Desktop (macOS)

Gehen Sie wie folgt vor, um das Excel-Add-In in Excel Desktop für macOS zu installieren:

1. Suchen Sie Ihren Microsoft Office Add-ins Ordner. Standardmäßig lautet das Verzeichnis:

   /Users/<your-username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef
   

2. Kopieren Sie die Add-In-Datei in diesen Ordner.

3. Öffnen oder starten Sie Excel Desktop.

4. Klicken Sie in der Navigationsleiste auf Add-Ins>Meine Add-Ins.

5. Klicken Sie auf das Azure Databricks-Add-In.

6. Schließen Sie den Anmeldevorgang für Ihr Azure Databricks Konto ab.

7. Wenn Sie mehrere Arbeitsbereich-URLs konfiguriert haben, wählen Sie den gewünschten Azure Databricks Kontonamen aus. Sie müssen nur einen bestimmten Arbeitsbereich auswählen, wenn sich die URLs innerhalb desselben Kontos befinden. Weitere Informationen zu Kontonamen finden Sie unter Suchen Ihrer Konto-ID.

Anmelden beim Add-In

Wenn ein Administrator in Ihrer Organisation das Azure Databricks Excel-Add-In bereitgestellt hat, melden Sie sich an, und stellen Sie eine Verbindung mit Ihrem Azure Databricks Arbeitsbereich von Excel her.

1. Klicken Sie in Excel unter der Registerkarte "Start" auf das Azure Databricks-Add-In.
2. Geben Sie Ihre Arbeitsbereichs-URL ein, oder wählen Sie eine zuvor verwendete Arbeitsbereichs-URL aus der Dropdownliste aus. Das Add-In merkt sich Arbeitsbereich-URLs, die Sie oder Ihr Administrator konfiguriert haben.
3. Klicken Sie auf Sign in und schließen Sie den Authentifizierungsprozess ab, um Zugriff auf alle Azure Databricks Excel-Add-In-Features zu erhalten.

Azure Databricks Arbeitsbereich ändern

Wenn Ihre Add-In-Datei mehrere Azure Databricks Arbeitsbereiche angibt, können Sie zwischen diesen Arbeitsbereichen wechseln. Weitere Informationen finden Sie unter Einrichten der Add-In-Datei.

Gehen Sie wie folgt vor, um eine Verbindung mit einem anderen Azure Databricks Arbeitsbereich herzustellen:

1. Klicken Sie oben rechts im Add-In-Bereich Azure Databricks auf das Dreipunktmenü neben der Computeauswahl.
2. Klicken Sie auf " Arbeitsbereich ändern".
3. Wählen Sie das Konto aus, in dem sich Ihr Arbeitsbereich befindet. Wählen Sie den Arbeitsbereich aus, wenn Sie dazu aufgefordert werden, und melden Sie sich an.

Problembehandlung

Meldung "Authentifizierung wird ausgeführt" bei der Anmeldung

Wenn beim Versuch, sich im Azure Databricks über das Add-in anzumelden, ein Fenster "Authentifizierung wird ausgeführt" angezeigt wird, wurde Ihr Arbeitsbereich vielleicht nicht korrekt in die benutzerdefinierte Add-In-Datei eingefügt. Vergewissern Sie sich, dass Sie Ihren Arbeitsbereich ordnungsgemäß konfiguriert haben unter <AppDomains>.

Meldung "Administratorgenehmigung erforderlich" bei der Anmeldung

Die folgende Meldung "Administratorgenehmigung erforderlich" wird angezeigt, wenn Sie sich bei Ihrem Azure Databricks Arbeitsbereich aus dem Excel add-in anmelden, da der Microsoft Entra Mandant die Benutzerzustimmung für die Azure Databricks Anwendung blockiert. Wenn keine Administratorzustimmung erteilt wird, blockiert Microsoft Entra ID den Anmeldefluss auch dann weiterhin, wenn Sie direkten Arbeitsbereichszugriff haben.

Um dies zu beheben, muss ein Microsoft Entra Benutzer mit entsprechenden Administratorrollen mandantenweite Administratorzustimmungen für die Azure Databricks Unternehmensanwendung erteilen:

1. Wechseln Sie im Microsoft Entra admin center zu Entra ID>Enterprise apps>All applications und suchen Sie die Azure Databricks Unternehmensanwendung, die für einmaliges Anmelden verwendet wird.
2. Erteilen Sie der Administratorzustimmung für die berechtigungen, die von der Azure Databricks Enterprise-App angefordert werden:
   1. Klicken Sie unter "Sicherheit" auf "Berechtigungen".
   2. Klicken Sie auf " Administratorzustimmung erteilen".

Ausführliche Anweisungen finden Sie in der dokumentation Microsoft.

Nicht in der Lage, Ressourcen zu verwenden.

Wenn Sie Azure Databricks Ressourcen wie SQL-Lagerhäuser im Azure Databricks-Add-In nicht verwenden können, probieren Sie eine der folgenden Methoden aus, je nachdem, welche Version von Excel Sie verwenden:

• Excel for the web: Starten Sie das Blatt neu, oder ändern Sie Arbeitsbereiche, und melden Sie sich wieder am gleichen Arbeitsbereich an. Siehe Change Azure Databricks Workspace.
• Excel Desktop: Laden Sie das Add-In neu, indem Sie in der oberen rechten Ecke auf das Informationssymbol klicken und Reload auswählen.

Nächste Schritte

• Importieren und Abfragen von Daten mithilfe des Azure Databricks Excel Add-Ins