Freigeben über

Einrichten des Excel-Add-Ins Azure Databricks

Von Bedeutung

Dieses Feature befindet sich in der Public Preview.

Das Excel-Add-In Azure Databricks verbindet Ihren Azure Databricks-Arbeitsbereich mit Microsoft Excel, wodurch verwaltete Lakehouse-Daten direkt in Ihre Kalkulationstabellen integriert werden, damit Sie schneller von Daten zu Entscheidungen wechseln können. Das Add-In wird in Excel für 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 Excel-Add-Ins Azure Databricks 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-Katalog für 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.
  • Zugriff auf ein ausgeführtes SQL Warehouse.
  • Berechtigungen zum Lesen von Daten aus Unity-Katalogtabellen in Ihrem Arbeitsbereich.
  • Sie verwenden eine der folgenden Excel-Versionen:
    • Excel 2019 oder höher auf einem Mac
    • Excel unter Windows (Microsoft 365)
    • Excel im Web
    • Excel für Mac (Microsoft 365)
  • Wenn Sie eine Firewall oder eine Cloudsicherheitsplattform verwenden, lassen Sie die UrLs des Azure Databricks-Arbeitsbereichs in der Add-In-Datei auflisten.

Einrichten der Add-In-Datei

Hinweis

Wenn Sie ein Administrator sind, der das Add-In über den Microsoft Marketplace bereitstellt, überspringen Sie diesen Abschnitt. Die Marketplace-Bereitstellung verwendet PowerShell zum Konfigurieren des Arbeitsbereichzugriffs anstelle der Add-In-Datei. Siehe Bereitstellen über Microsoft Marketplace.

Die Add-In-Datei ist eine kleine Connectordatei, 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 bei jedem Öffnen von Excel auf dem neuesten Stand bleibt.

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

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

    Excel-Add-In-Datei für Azure Databricks

  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 unter" 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 jedes Arbeitsbereichs 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 Ctrl+Shift+V in den meisten Text-Editoren (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 Excel-Add-In Azure Databricks 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 Excel-Add-In Azure Databricks als Microsoft 365-Administrator zu installieren, müssen Sie über die global admin Berechtigung verfügen. 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 Microsoft-Dokumentation.

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 " Integrierte Einstellungen > "-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 Excel-Add-Ins azure Databricks finden Sie in der Microsoft-Dokumentation.

Bereitstellung aus dem 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 den integrierten Einstellungen > , und klicken Sie auf den Link "Apps abrufen ".
  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 Excel-Add-Ins Azure Databricks aus dem Microsoft Marketplace finden Sie in der Microsoft-Dokumentation.

Konfigurieren des Arbeitsbereichzugriffs

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

Hinweis

Die PowerShell-Verbindung zum Office 365 Admin Center kann zu Zeitüberschreitungen kommen. Wenn ein Befehl fehlschlägt, öffnen Sie PowerShell erneut, und stellen Sie die Verbindung erneut her, indem Sie Connect-OrganizationAddInService ausführen.

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

  2. Installieren und Importieren des zentralen Office 365-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. URLs der Azure Databricks-Arbeitsbereiche zur Zulassenliste hinzufügen. 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 lautet 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.

Hinweis

Die Änderungen an der Zulassungsliste können einige Minuten benötigen, um synchronisiert zu werden. Wenn die Authentifizierung fehlschlägt, stellen Sie sicher, dass Sie mit einem zugelassenen Arbeitsbereich verbunden sind. Wenn der Arbeitsbereich korrekt ist, schließen Sie Excel, warten Sie einige Minuten, und versuchen Sie es erneut.

Bereitstellen in Ihrer Organisation

  1. Wechseln Sie im Microsoft 365 Admin Center zu " Integrierte Einstellungen > "-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.

Hinweis

Geben Sie als Administrator den Kontonamen an die Benutzer frei, die das Azure Databricks Excel-Add-In verwenden möchten, das den von Ihnen zugelassenen Arbeitsbereichen zugeordnet ist. Siehe Anmelden beim Add-In.

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 in Excel für das Web zu installieren und eine Verbindung herzustellen:

  1. Öffnen Sie Excel für das 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, damit es dem Manifestordner vertraut:
    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 "Hinzufügen".
  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 neu.

  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 bei Ihrem 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 Excel-Add-In Azure Databricks bereitgestellt hat, melden Sie sich an, und stellen Sie eine Verbindung mit Ihrem Azure Databricks-Arbeitsbereich aus Excel her.

  1. Klicken Sie in Excel auf 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 "Anmelden" , und schließen Sie den Authentifizierungsprozess ab, um Zugriff auf alle Excel-Add-In-Features von Azure Databricks zu erhalten.

Ändern des Azure Databricks-Arbeitsbereichs

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 von Azure Databricks auf das Menü mit den drei Punkten neben der Berechnungsauswahl.
  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 bei Azure Databricks aus dem Add-In anzumelden, ein Fenster "Authentifizierung in Bearbeitung" angezeigt wird, wurde Ihr Arbeitsbereich möglicherweise nicht ordnungsgemäß zur benutzerdefinierten Add-In-Datei hinzugefügt. Vergewissern Sie sich, dass Sie Ihren Arbeitsbereich ordnungsgemäß konfiguriert haben unter <AppDomains>.

Nicht in der Lage, Ressourcen zu verwenden.

Wenn Sie Azure Databricks-Ressourcen, z. B. SQL Warehouses, nicht im Azure Databricks-Add-In verwenden können, probieren Sie eine der folgenden Methoden aus, je nachdem, welche Excel-Version Sie verwenden:

  • Excel für das Web: Starten Sie das Blatt neu, oder ändern Sie Arbeitsbereiche, und melden Sie sich wieder am gleichen Arbeitsbereich an. Siehe Ändern des Azure Databricks-Arbeitsbereichs.
  • Excel Desktop: Laden Sie das Add-In neu, indem Sie in der oberen rechten Ecke auf das Informationssymbol klicken und " Neu laden" auswählen.

Nächste Schritte

  • Last updated on