Importera och fråga efter data med hjälp av Azure Databricks Excel-tillägget

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.

På den här sidan beskrivs hur du använder Azure Databricks Excel-tillägget för att importera och analysera data från Azure Databricks i Excel. Du kan bläddra i och importera Azure Databricks tabeller via ett intuitivt gränssnitt där ingen SQL-kunskap krävs. Tillägget ger flexibiliteten att köra anpassade SQL-frågor, men det är valfritt.

Förutsättningar

Innan du använder Excel-tillägget kontrollerar du att du har det konfigurerat.

Välj ett SQL-lager

Välj vilket SQL-lager som ska användas:

1. Klicka på den nedrullningsbara menyn längst upp till höger i fönstret Azure Databricks Tillägg i Excel.
2. Välj vilket SQL-lager du vill använda.

Importera data från Azure Databricks

Importera data från Azure Databricks i Excel genom att välja en tabell, skriva en SQL-fråga eller importera en pivottabell.

Skapa pivottabeller

Så här skapar du en pivottabell från Unity Catalog-tabeller och vyer i Excel:

1. I fönstret Azure Databricks Excel Tillägg går du till fliken Ny import och väljer Välj data som metoden Importera.

2. Under Katalog väljer du den tabell som du vill skapa en pivottabell från och klickar på Välj.

3. Markera kryssrutan Pivotdata .

4. Konfigurera rad, kolumn, värde och filter efter behov.

5. (Valfritt) Om du vill se ett exempel på importen klickar du på Förhandsgranska.

6. (Valfritt) Ange en radgräns för din import.

7. Importera dina resultat. Välj något av följande:

   • Klicka på Spara och importera för att spara frågan för återanvändning i arbetsboken Excel och importera resultatet.
   • Klicka på nedåtpilen och klicka sedan på Importera resultat för att importera resultatet utan att spara frågan. Använd det här alternativet när du vill fortsätta redigera en import.

   Anmärkning

   Pivottabeller kan bara importeras till ett nytt blad.

När du arbetar med Unity Catalog-mått i pivottabeller kan Sum(measure) finnas i resultatet. Detta är ett förväntat beteende och ingen ytterligare aggregering sker. Excel kräver att värden har en aggregeringsfunktion, men eftersom data innehåller unika värden sker ingen aggregering.

Välj tabeller

Data importeras som ett Excel-tabell objekt. Du kan flytta tabellen eller byta namn på bladet och Excel-tillägget uppdaterar data på den nya platsen.

Om du vill importera data från en Azure Databricks tabell gör du följande:

1. I fönstret Azure Databricks Excel Tillägg går du till fliken Ny import och väljer Välj data som metoden Importera.

2. Välj en tabell som ska importeras från Katalogutforskaren. Du kan filtrera katalogen efter ägare, certifieringsstatus och andra egenskaper med hjälp av

3. Klicka på Välj.

4. Under Kolumner klickar du på nedåtpilen och avmarkerar de kolumner som du inte vill importera, eller lämnar alla kolumner markerade för att importera hela tabellen.

5. (Valfritt) Om du vill ange filter klickar du + bredvid Filter, väljer den kolumn som du vill använda ett filter för och anger sedan ditt filtervillkor. En lista över tillgängliga filter finns i Filter som stöds.

   För filter som kräver ett värde kan du göra något av följande:

   • Ange värdet.
   • Om du vill generera en lista med upp till 75 distinkta filtervärden som du kan använda klickar du på Värden och sedan på Hämta filtervärden. Klicka på nedåtpilen och välj ett eller flera värden i listan.
   • Om du vill använda en cellreferens klickar du på Celler, markerar en cell eller ett cellområde och klickar sedan på markören.

   Anmärkning

   Filtervärden får inte innehålla kommatecken. Om du vill filtrera efter värden som innehåller kommatecken använder du metoden Skriv SQL-import i stället

6. (Valfritt) Om du vill se ett exempel på importen klickar du på Förhandsgranska.

7. (Valfritt) Du kan ange en radgräns för att begränsa antalet importerade rader.

8. (Valfritt) Du kan enkelt identifiera dina importerade data genom att ange ett importnamn.

9. Under Utdatamål väljer du att importera data till ett nytt blad eller det aktuella bladet. Om du importerar till det aktuella bladet börjar data vid cellreferensen du anger (som standard A1).

10. Importera dina resultat. Välj något av följande:

    • Klicka på Spara och importera för att spara frågan för återanvändning i arbetsboken Excel och importera resultatet.
    • Klicka på nedåtpilen och klicka sedan på Importera resultat för att importera resultatet utan att spara frågan. Använd det här alternativet när du vill fortsätta redigera en import.

Filter som stöds

När du importerar data genom att välja en tabell kan du använda filter för att begränsa resultatet. I följande tabell beskrivs varje tillgängligt filter och dess förväntade indata.

Skriva SQL-frågor

Importmetoden Write SQL stöder SQL-funktioner och lagrade procedurer.

Om du vill köra anpassade SQL-frågor mot din Azure Databricks arbetsyta gör du följande:

1. I fönstret Azure Databricks Excel Tillägg går du till fliken Ny import väljer du Write SQL som metoden Importera.

2. Ange ett namn på frågan för att identifiera den senare.

3. Skriv en ny fråga eller använd en befintlig fråga från din Azure Databricks arbetsyta.

   • Skriv DIN SQL-fråga i redigeraren. Du kan köra frågor mot valfri tabell i Unity Catalog som du har behörighet att komma åt.

     • Klicka på Katalogutforskaren för att visa dina scheman och tabeller.

   • Om du vill använda en fråga från din Azure Databricks arbetsyta eller en befintlig fråga i Excel klickar du på mappen. Om du använder en befintlig fråga från din Azure Databricks arbetsyta återspeglas inte ändringar som gjorts i Excel på Azure Databricks.

     Anmärkning

     Frågor måste sparas explicit i Azure Databricks med hjälp av knappen Spara i frågeredigeraren innan de visas i Excel.

4. (Valfritt) Om du vill lägga till frågeparametrar klickar du på +Lägg till bredvid Parametrar. Klicka på parametern och ange parameternamnet och parametervärdet.

   • För parametervärdet kan du antingen ange ett specifikt värde eller klicka på rutan och pilknappen för att ange en cellreferens. Markera en cell eller ett cellområde och klicka på pilen för att automatiskt fylla parametervärdet.

5. Under Utdatamål väljer du att importera data till ett nytt blad eller det aktuella bladet. Om du importerar till det aktuella bladet börjar data vid cellreferensen du anger (som standard A1).

6. Om du vill förhandsgranska frågeresultatet klickar du på Kör.

7. Importera dina resultat. Välj något av följande:

   • Klicka på Spara och importera för att spara frågan för återanvändning i arbetsboken Excel och importera resultatet.
   • Klicka på nedåtpilen och klicka sedan på Importera resultat för att importera resultatet utan att spara frågan. Använd det här alternativet när du vill fortsätta redigera en import.

Du kan också använda anpassade funktioner för att lägga till frågeparametrar. Se även Skriva SQL.

Använd anpassade funktioner i Excel

Excel-tillägget innehåller anpassade funktioner som du kan använda i Excel formler för att importera data från Azure Databricks.

Välj en tabell

Funktionen DATABRICKS.Table importerar data från en Unity Catalog-tabell.

Syntax:

=DATABRICKS.Table(catalog_name.schema_name.table_name, [column1, ...], [limit])

Parameters:

• catalog_name.schema_name.table_name (krävs): Det fullständigt kvalificerade tabellnamnet.
• columns (valfritt): En matris med kolumnnamn som ska importeras. Utelämna den här parametern för att importera alla kolumner.
• limit (valfritt): Det maximala antalet rader som ska importeras. Utelämna den här parametern för att importera alla rader, upp till gränsen på 10 MB.

Ett exempel:

=DATABRICKS.Table("main.default.customers", {"customer_id", "customer_name"}, 100)

Den här formeln importerar kolumnerna customer_id och customer_name från main.default.customers tabellen, begränsat till 100 rader.

Skriva SQL

Funktionen DATABRICKS.SQL kör en SQL-fråga som använder frågeparametrar och returnerar resultatet.

Syntax:

Ange parametrar med hjälp av värden.

=DATABRICKS.SQL("query_text", {parameter1_name, parameter1_value; ...})

Ange parametrar med ett cellområde. Namn- och värdeparametrarna måste definieras i celler som finns på samma rad.

=DATABRICKS.SQL("query_text", {param_name_cell: param_value_cell; ...})

Parameters:

• query_text (krävs): SQL-frågan som ska köras.
• parameters (krävs): En mappning av parametervärden som ska ersättas i frågan.

Ett exempel:

=DATABRICKS.SQL("SELECT * FROM samples.bakehouse.sales_suppliers WHERE longitude > :long_param AND latitude > :lat_param LIMIT 10", {"long_param",20; "lat_param",10})

=DATABRICKS.SQL("SELECT * FROM samples.bakehouse.sales_suppliers WHERE city = :city", M4:N4)

Den här formeln kör en fråga som filtrerar försäljningsdata efter longitude och latitude med hjälp av de angivna parametervärdena.

Hantera frågor

Hantera dina befintliga importer från sidan Importer.

Redigera en befintlig import

Så här redigerar du en befintlig import:

1. Klicka på fliken Imports i fönstret Azure Databricks Add-in i Excel.
2. Leta reda på den import som du vill redigera.
3. Klicka på menyn med tre punkter bredvid importen.
4. Klicka på Redigera för att redigera importen.

Uppdatera data

Det Excel tillägget uppdaterar inte importerade data automatiskt. Så här uppdaterar du dina data med de senaste värdena från Azure Databricks:

• Om du vill uppdatera en enskild import gör du följande:
  1. Klicka på fliken Imports i fönstret Azure Databricks Add-in i Excel.
  2. Klicka på Uppdatera bredvid den import som du vill uppdatera.
• Gör följande för att uppdatera alla importer:
  1. Klicka på Refresh All i Azure Databricks tilläggsfönster.

Tillägget kör den ursprungliga frågan eller tabellmarkeringen igen och uppdaterar kalkylbladet med nya data.

Delningskonsekvenser

När du delar en Excel arbetsbok som innehåller Azure Databricks data bör du överväga följande konsekvenser för dataåtkomst och säkerhet:

Synlighet för importerade data

När en mottagare uppdaterar en import använder tillägget mottagarens Unity Catalog-behörigheter. Om de inte har åtkomst till underliggande data misslyckas uppdateringen.

För arbetsböcker där datasekretess är ett problem kan du använda följande lösning:

1. Skapa en arbetsbok med alla nödvändiga formler och importer.
2. Ta bort importerade data från bladet.
3. Dela arbetsboken med mottagaren.
4. Låt mottagaren uppdatera data.

Mottagaren ser endast data som de har åtkomst till baserat på deras behörigheter för Unity-katalogen.

Åtkomst till arbetsytor och datatillgångar

• Användare utan åtkomst till Unity Catalog-objekten som refereras i arbetsboken kan inte uppdatera data. För att uppdatera data måste användarna ha läsbehörighet för de underliggande tabellerna och vyerna i Unity Catalog.
• Användarna måste ha åtkomst till den underliggande tabellen i Azure Databricks för att kunna redigera befintliga importer.

Sökfrågans synlighet

Användare med redigeringsåtkomst till arbetsboken kan visa de frågor som används för att generera data via Azure Databricks-tillägget, även om de inte har åtkomst till underliggande data i Unity Catalog.

Begränsningar

• Anpassade funktioner: För anpassade funktioner begränsas frågeresultatet till 25 MiB på grund av begränsningar i SQL-körnings-API:et.
• Datainläsning: Datainläsningen kan misslyckas om någon cell i arbetsboken är i redigeringsläge.
• Excel Desktop-radgräns: Excel Desktop stöder högst 1 048 576 rader per blad.
• Excel för webben filstorleksgräns: Excel för webben stöder en maximal filstorlek på cirka 25 MB för visning och redigering.