Konfigurera Azure Databricks Excel-tillägget

Azure Databricks Excel-tillägget kopplar din Azure Databricks arbetsyta till Microsoft Excel och för styrd Lakehouse-data direkt till dina kalkylblad. Tillägget stöds fullt ut i Excel för webb- 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.
• Du har Azure Databricks SQL-åtkomst och minst KAN ANVÄNDA behörighet på ett SQL-lager. För att importera data med låg latens kan du också använda ett Lakehouse//RT-lager , som endast stödjer import.
• 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 i Windows (Microsoft 365)
  • Excel på webben
  • Excel på Mac (Microsoft 365)
• Om du använder en brandvägg eller en molnsäkerhetsplattform tillåter du listan över URL:er för Azure Databricks-arbetsytan som ingår i tilläggsfilen.
• Om din Microsoft Entra-hyresgäst blockerar användarens samtycke för tredjepartsappar måste en Microsoft Entra-administratör ge administratörssamtycke till Azure Databricks single sign-on företagsapplikation innan användare kan logga in med kontoväljaren. Detta krävs inte om användare loggar in genom att ange en arbetsplats-URL direkt. Se meddelandet "Behöver administratörsgodkännande" vid inloggning.

Konfigurera tilläggsfilen

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

Ladda ned och konfigurera tilläggsfilen så att den använder Azure Databricks Excel-tillägget. En enda tilläggsfil kan ansluta till flera Azure Databricks-arbetsytor.

1. Ladda ned filen Azure Databricks Excel add-in:

   Ladda ned Excel-tilläggsfilen

2. Redigera tilläggsfilen genom att ange din arbetsyte-URL som en <AppDomain> i avsnittet AppDomains . Webbadressen till arbetsytan är den grundläggande URL:en 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.

   För att logga in med en anpassad URL, lägg till både den anpassade URL:en och den tillhörande arbetsytans URL som separata <AppDomain>-poster, som visas i följande exempel. Inloggning kan omdirigera till vilken URL som helst.

   <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>
      <!-- TO USE A CUSTOM URL, ADD BOTH THE CUSTOM URL AND ITS ASSOCIATED WORKSPACE URL -->
      // highlight-next-line
      <AppDomain>https://<custom-url>.azuredatabricks.net</AppDomain>
   </AppDomains>
   

   Note

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

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

Alternativ 1: Distribuera från Administrationscenter för Microsoft 365

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 Microsoft 365-administratör 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 Microsoft-dokumentationen.

Få tillgång till Administrationscenter för Microsoft 365 här.

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 administrationscentret för Microsoft 365 går du till Inställningar > Integrerade appar och klickar på länken Tillägg .
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. I rullgardinsmenyn för apptyp , välj Office-tillägg.
5. Välj alternativet Ladda upp manifestfil (.xml) från enheten. Klicka på Välj fil och ladda upp tilläggsfilen.
6. Välj vilka användare som ska ha åtkomst till tillägget.
7. Klicka på Distribuera.

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

Distribuera från Microsoft Marketplace

Installera tillägget från Microsoft Marketplace och använd PowerShell för att konfigurera åtkomst till arbetsytor. Att installera tillägget ensamt kopplar det inte till dina Azure Databricks-arbetsytor. Följ alla stegen nedan, inklusive att lägga till URL:erna för din arbetsyta i listan över tillåtna adresser med PowerShell.

Prerequisites

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

Installera tillägget

1. I administrationscentret för Microsoft 365 går du till Inställningar > Integrerade appar och klickar på länken Hämta appar .
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 steg om hur du distribuerar Azure Databricks Excel-tillägget från Microsoft Marketplace finns i Microsoft-dokumentationen.

Konfigurera åtkomst till arbetsyta

När du har installerat tillägget använder du PowerShell för att tillåta listning av URL:erna för ditt Azure Databricks-arbetsyta.

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

2. Installera och importera den centraliserade distributionsmodulen för Office 365:

   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. 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. För att stödja en anpassad URL, inkludera både den anpassade URL:en och den tillhörande workspace-URL: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", "https://<custom-url>.azuredatabricks.net"
   

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

   Kommandot kan returnera There was an error uploading the Add-In även när workspace-URL:erna har lagts till i tillåtslistan. Innan du kör kommandot igen, gör nästa steg för att kontrollera om tillåtlistningen har tillämpats.

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. I Excel hittar du Azure Databricks-tillägget.
2. Logga in och anslut till någon av de arbetsytor som du har listat.

Distribuera till din organisation

1. I administrationscentret 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.

Alternativ 2: Distribuera som en individuell användare

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ägget på menyn Tillägg .
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)

Installera inte tillägget från fliken Store . Ett tillägg som installeras på detta sätt ansluter inte till ditt arbetsområde. Installera Excel-tillägget i Excel Desktop för Windows från fliken Delad mapp:

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 för 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. Under fliken Hem, klicka på Tillägg>Fler tillägg.
8. Under Delad mapp, välj Azure Databricks Add-in för Excel.
9. Slutför inloggningsprocessen till 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. Kopiera tilläggsfilen till din Microsoft Office Add-ins-mapp. wef Om mappen inte finns skapar du den.

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

2. Öppna eller starta om Excel Desktop.

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

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

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

6. 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. Klicka på Azure Databricks-tillägget under fliken Start i Excel.

2. Första gången du loggar in, koppla upp dig till en arbetsplats med ett av följande alternativ:

   • Ange en workspace-URL (rekommenderad): Ange din Azure Databricks workspace-URL. Detta alternativ loggar in dig med workspace SSO. För att logga in med en anpassad URL, kontrollera att både den anpassade URL:en och den tillhörande workspace-URL:en har lagts till i tilläggsfilen. Se Sätt upp tilläggsfilen.
   • Använd kontoväljaren: Klicka på Välj kontoväljare för att öppna login.databricks.com, och välj sedan ett tillåtet konto och arbetsområde.

3. Klicka på Logga in och slutför autentiseringsprocessen för att få tillgång till Azure Databricks Excel-tillägget.

Efter din första inloggning minns tillägget dina arbetsytor. Vid senare inloggningar, välj en arbetsyta från rullgardinsmenyn eller använd något av alternativen ovan för att ansluta till en annan arbetsplats.

Om du använder Microsoft Entra ID-autentisering och meddelandet "Behöver administratörsgodkännande" visas, måste en Microsoft Entra-administratör godkänna Azure Databricks företagsapplikation innan du kan logga in. Se meddelandet "Behöver administratörsgodkännande" vid inloggning.

Ä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. I det övre högra hörnet av fönstret Azure Databricks-tillägg klickar du på menyn med tre punkter bredvid beräkningsväljaren.
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. Detta gäller endast när du loggar in med kontoväljaren (login.databricks.com); för att undvika det, ange din workspace-URL direkt när du loggar in. Om administratörsmedgivande inte beviljas fortsätter Microsoft Entra ID att blockera inloggningsflödet även om du har direkt åtkomst till arbetsytan.

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.

Be Microsoft Entra administratören att besöka följande länk. Ersätt {TENANT_ID} med ditt Microsoft Entra klient-ID:

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

Om länken misslyckas kan administratören bevilja medgivande manuellt:

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. Om du vill identifiera programmet söker du efter program-ID: t aaec40b0-c0ae-4211-a98b-6fc160abb71b.
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 Ändra 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 Läs in igen.

Nästa steg

• Importera och fråga efter data med hjälp av Azure Databricks Excel-tillägget
• Använd Genie One i Microsoft Excel