Dela via

Konfigurera Azure Databricks Excel-tillägget

Viktigt!

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Azure Databricks Excel-tillägget ansluter din Azure Databricks arbetsyta till Microsoft Excel, vilket gör att reglerade Lakehouse-data hamnar direkt i kalkylbladen så att du kan gå från data till beslut snabbare. Tillägget stöds fullt ut i Excel för webben- och skrivbordsversioner för både Windows och macOS.

På den här sidan beskrivs de två metoder som är tillgängliga för att konfigurera Azure Databricks Excel-tillägget i Microsoft Excel. Det här tillägget använder enkel inloggningsautentisering (SSO) för att ansluta till din Azure Databricks arbetsyta och stöder Unity Catalog för datastyrning och åtkomstkontroll.

Förutsättningar

Innan du installerar Excel-tillägget kontrollerar du att du har följande:

  • Åtkomst till en Azure Databricks arbetsyta med Unity Catalog aktiverat.
  • URL för Azure Databricks arbetsyta för varje arbetsyta som Excel ska ansluta till. Url:er för anpassade konton stöds inte.
  • Åtkomst till ett SQL-lager som körs.
  • Behörigheter för att läsa data från Unity Catalog-tabeller på din arbetsyta.
  • En av följande versioner av Excel:
    • Excel 2019 eller senare på Mac
    • Excel på Windows (Microsoft 365)
    • Excel på webben
    • Excel på Mac (Microsoft 365)
  • Om du använder en brandvägg eller en molnsäkerhetsplattform tillåter dulistning av url:er för Azure Databricks arbetsyta som ingår i tilläggsfilen.

Konfigurera tilläggsfilen

Anmärkning

Om du är administratör och distribuerar tillägget via Microsoft Marketplace hoppar du över det här avsnittet. Marketplace-distributionen använder PowerShell för att konfigurera åtkomst till arbetsytor i stället för tilläggsfilen. Se Distribution via Microsoft Marketplace.

Tilläggsfilen är en liten anslutningsfil som talar om för Excel exakt hur du ansluter till Azure Databricks på ett säkert sätt. Det fungerar som en digital handskakning som säkerställer att tilläggsprogrammet läses in korrekt, och håller sig uppdaterat varje gång du öppnar Excel.

Ladda ned och konfigurera tilläggsfilen så att den använder Azure Databricks Excel-tillägget.

  1. Öppna tilläggsfilen genom att klicka på följande länk:

    Azure Databricks Excel-tilläggsfilen

  2. Spara sidan som en .xml fil på den lokala datorn. Högerklicka på sidan i de flesta webbläsare och välj Spara som eller tryck på Ctrl+S (Windows) eller Command+S (macOS).

  3. Redigera tilläggsfilen genom att ange din arbetsyte-URL som en <AppDomain> i avsnittet AppDomains . Webbadressen till arbetsytan är den bas-URL som du använder för att komma åt din Azure Databricks arbetsyta i en webbläsare. Om du vill växla mellan flera Azure Databricks arbetsytor lägger du till varje arbetsyte-URL i tilläggsfilen.

    <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>

    Anmärkning

    Klistra in din arbetsyte-URL som oformaterad text, utan formatering. I de flesta textredigerare använder du Ctrl+Shift+V (Windows) eller Command+Shift+V (macOS).

  4. Spara dina ändringar. Kontrollera att filen är korrekt formaterad som en .xml fil.

Alternativ 1: Administratörshanterad

Som global administratör kan du distribuera Azure Databricks Excel-tillägget till användare i din organisation. Du kan distribuera tillägget som en anpassad app med hjälp av tilläggsfilen eller installera det från Microsoft Marketplace.

Om du vill installera Azure Databricks Excel-tillägget som en Microsoft 365 Admin måste du ha behörigheten global admin. Som administratör kan du avgöra vilka användare i din organisation som kan använda tillägg. Mer information om globala administratörer på Microsoft 365 finns i dokumentationen Microsoft.

Distribuera som en anpassad app

Distribuera tillägget med hjälp av en anpassad manifestfil. Ladda ned och konfigurera tilläggsfilen som anges i förutsättningar.

  1. I Administrationscenter för Microsoft 365 går du till Inställningar > Integrerade appar och klickar på länken Lägg till.
  2. Klicka på Distribuera tillägg och klicka på Nästa.
  3. Klicka på Ladda upp anpassade appar som alternativ för att distribuera ett nytt tillägg.
  4. Välj alternativet för att ladda upp ett manifest. Klicka på Välj fil och ladda upp tilläggsfilen.
  5. Välj vilka användare som ska ha åtkomst till tillägget.
  6. Klicka på Distribuera.

Detaljerade anvisningar om hur du laddar upp Azure Databricks Excel-tillägget finns i dokumentationen Microsoft.

Distribuera från Microsoft Marketplace

Installera tillägget från Microsoft Marketplace och använd PowerShell för att konfigurera åtkomst till arbetsytor.

Förutsättningar

  • PowerShell är installerat på datorn.
  • Du måste köra Windows PowerShell som administratör.

Installera tillägget

  1. I Administrationscenter för Microsoft 365 går du till Inställningar > Integrerade appar och klickar på länken Get Apps.
  2. Sök efter "Azure Databricks tillägg för Excel".
  3. Klicka på Hämta nu.
  4. Distribuera tillägget till dig själv genom att välja Bara mig under Tilldela användare.
  5. Klicka på Distribuera.

Detaljerade anvisningar om hur du distribuerar Azure Databricks Excel-tillägget från Microsoft Marketplace finns i dokumentationen Microsoft.

Konfigurera åtkomst till arbetsyta

Efter att du har installerat tillägget använder du PowerShell för att vitlista URL:erna för din Azure Databricks-arbetsyta.

Anmärkning

Anslutningen till PowerShell i administrationscentret för Office 365 kan bli inaktiv på grund av tidsgräns. Om ett kommando misslyckas öppnar du PowerShell igen och återansluter genom att köra Connect-OrganizationAddInService.

  1. Öppna PowerShell och kör som administratör. Mer information finns i dokumentationen Microsoft.

  2. Installera och importera Office 365 centraliserad distributionsmodul:

    Install-Module -Name O365CentralizedAddInDeployment
Import-Module O365CentralizedAddInDeployment

  3. Anslut och logga in på din Office 365 klientorganisation som administratör:

    Connect-OrganizationAddInService

  4. Bekräfta att tillägget har distribuerats. Det Azure Databricks tillägget för Excel bör visas i listan.

    Get-OrganizationAddIn

    Om tillägget inte visas kan det behöva distribueras på nytt eller hålla på att distribueras.

  5. Godkänna lista Azure Databricks URL:er för arbetsytor. Ersätt varje <workspace-url> med URL:en till den arbetsyta du vill tillåta. Du kan inkludera så många url:er för arbetsytor som du behöver.

    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"

    Produkt-ID:t för Azure Databricks är d75dbea5-bf93-49b8-9a49-bdf4e9d6f052.

  6. Bekräfta korrekt vitlistning. Url:erna för arbetsytan som du har listat bör visas i avsnittet AppDomains .

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

Testa tillägget

  1. Leta upp Azure Databricks-tillägget i Excel.
  2. Logga in och anslut till någon av de arbetsytor som du har listat.

Anmärkning

Det kan ta några minuter att synkronisera tillåtna ändringar. Om autentiseringen misslyckas kontrollerar du att du ansluter till en tillåten arbetsyta. Om arbetsytan är korrekt stänger du Excel, väntar några minuter och försöker igen.

Distribuera till din organisation

  1. I Administrationscenter för Microsoft 365 går du till Inställningar > Integrerade appar.
  2. Välj det Azure Databricks tillägg som du har installerat och konfigurerat.
  3. Klicka på fliken Användare och välj om du vill distribuera till hela organisationen eller en specifik grupp med användare.

Anmärkning

Som administratör delar du det kontonamn som är associerat med de arbetsytor som du tillåterlistade med de användare som planerar att använda Azure Databricks Excel-tillägget. Se Logga in på tillägget.

Alternativ 2: Självbetjäning

Installationsstegen varierar beroende på din Excel plattform. Ladda ned och konfigurera tilläggsfilen som anges i förutsättningar.

Excel för webben

Om du vill installera och ansluta till Excel-tillägget i Excel för webben gör du följande:

  1. Öppna Excel för webben och skapa eller öppna en arbetsbok.
  2. Under fliken Start klickar du på Tillägg>Avancerat.
  3. Klicka på Ladda upp mitt tillägg.
  4. Ladda upp tilläggsfilen.
  5. Klicka på Överför.
  6. Leta upp och klicka på Azure Databricks-tillägg från menyn Lägg till.
  7. Logga in på ditt Azure Databricks-konto. Om det uppstår ett fel måste du aktivera popup-dialogrutor.
  8. Om du har konfigurerat flera url:er för arbetsytan väljer du önskat Azure Databricks kontonamn. Du behöver bara välja en specifik arbetsyta om URL:erna finns i samma konto. Mer information om kontonamn finns i Hitta ditt konto-ID.

Excel Desktop (Windows)

Gör följande för att installera Excel-tillägget i Excel Desktop för Windows:

  1. Skapa en mapp med namnet Manifest på den lokala enheten (till exempel C:\Manifest).
  2. Kopiera tilläggsfilen till C:\Manifest mappen.
  3. Öppna mappegenskaperna och dela mappen:
    1. Högerklicka på Manifest mappen och välj Egenskaper.
    2. Klicka på Dela>Dela och lägg till dig själv som användare med läs- och skrivbehörighet.
  4. Öppna Excel Desktop.
  5. Konfigurera Excel att lita på manifestmappen:
    1. Klicka på Arkiv>Alternativ>Säkerhetscenter>Inställningar för Säkerhetscenter.
    2. I sidofältet klickar du på Betrodda tilläggskataloger.
    3. I Katalog-URL anger du sökvägen till den delade mappen där tilläggsfilen finns (till exempel \\YourComputerName\Manifest).
    4. Klicka på Lägg till katalog.
    5. Markera kryssrutan Visa på menyn .
    6. Spara ändringarna genom att klicka på OK .
  6. Starta om Excel Desktop.
  7. Klicka på Tillägg>Fler delade tilläggsmappar>.
  8. Välj anslutningsappen Azure Databricks och klicka på Lägg till.
  9. Klicka på Azure Databricks-tillägget och slutför inloggningsprocessen för ditt Azure Databricks-konto.
  10. Om du har konfigurerat flera url:er för arbetsytan väljer du önskat Azure Databricks kontonamn. Du behöver bara välja en specifik arbetsyta om URL:erna finns i samma konto. Mer information om kontonamn finns i Hitta ditt konto-ID.

Excel Desktop (macOS)

Så här installerar du Excel-tillägget i Excel Desktop för macOS:

  1. Leta upp din Microsoft Office Add-ins-mapp. Som standard är katalogen:

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

  2. Kopiera tilläggsfilen till den här mappen.

  3. Öppna eller starta om Excel Desktop.

  4. I navigeringsfältet klickar du på Tillägg>Mina tillägg.

  5. Klicka på Azure Databricks-tillägget.

  6. Slutför inloggningsprocessen till ditt Azure Databricks-konto.

  7. Om du har konfigurerat flera url:er för arbetsytan väljer du önskat Azure Databricks kontonamn. Du behöver bara välja en specifik arbetsyta om URL:erna finns i samma konto. Mer information om kontonamn finns i Hitta ditt konto-ID.

Logga in på tillägget

Om en administratör i din organisation har distribuerat Azure Databricks Excel-tillägget loggar du in och ansluter till din Azure Databricks arbetsyta från Excel.

  1. I Excel klickar du på det Azure Databricks tillägget under fliken Start.
  2. Ange din url för arbetsytan eller välj en tidigare använd arbetsyte-URL i listrutan. Tillägget kommer ihåg url:er för arbetsytor som du eller administratören har konfigurerat.
  3. Klicka på Sign in och slutför autentiseringsprocessen för att få åtkomst till alla Azure Databricks Excel tilläggsfunktioner.

Ändra Azure Databricks arbetsyta

Om tilläggsfilen anger flera Azure Databricks arbetsytor kan du växla mellan dessa arbetsytor. Mer information finns i Konfigurera tilläggsfilen.

Gör följande för att ansluta till en annan Azure Databricks arbetsyta:

  1. Klicka på menyn med tre punkter bredvid beräkningsväljaren längst upp till höger i fönstret Azure Databricks Tillägg.
  2. Klicka på Ändra arbetsyta.
  3. Välj det konto som din arbetsyta är i, arbetsytan om du uppmanas till det och logga in.

Felsökning

Meddelandet "Autentisering pågår" vid inloggning

Om fönstret "Autentisering pågår" visas när du försöker logga in på Azure Databricks från tillägget kanske arbetsytan inte har lagts till korrekt i den anpassade tilläggsfilen. Kontrollera att du har konfigurerat arbetsytan korrekt under <AppDomains>.

Meddelandet "Behöver administratörsgodkännande" vid inloggning

Följande meddelande "Behöver administratörsgodkännande" visas när du loggar in på din Azure Databricks arbetsyta från Excel add-in eftersom Microsoft Entra klientorganisation blockerar användarens medgivande för Azure Databricks-programmet. Om administratörsmedgivande inte beviljas fortsätter Microsoft Entra ID att blockera inloggningsflödet även om du har direkt åtkomst till arbetsytan.

Behövs administratörsgodkännande i Excel-tillägget

För att lösa detta måste en Microsoft Entra användare med lämpliga administratörsroller bevilja administratörsmedgivande för hela klientorganisationen till Azure Databricks företagsprogram:

  1. I Microsoft Entra administrationscenter går du till Entra ID>Enterprise-appar>Alla program och hittar det Azure Databricks företagsprogram som används för enkel inloggning.
  2. Bevilja administratörsmedgivande för de behörigheter som begärs av Azure Databricks enterprise-appen:
    1. Under Säkerhet klickar du på Behörigheter.
    2. Klicka på Bevilja administratörsmedgivande.

Detaljerade anvisningar finns i dokumentationen Microsoft.

Det går inte att använda resurser

Om du inte kan använda Azure Databricks resurser, till exempel SQL-lager, i Azure Databricks-tillägget kan du prova någon av följande metoder beroende på vilken version av Excel du använder:

  • Excel för webben: Starta om bladet eller ändra arbetsytor och logga in på samma arbetsyta igen. Se Change Azure Databricks arbetsyta.
  • Excel Desktop: Läs in tillägget igen genom att klicka på informationsikonen i det övre högra hörnet och välja Reload.

Nästa steg

  • Last updated on