Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Note
De Azure Databricks Excel-invoegtoepassing is niet beschikbaar in de Azure Government- of Azure China-regio.
De Azure Databricks Excel Add-in verbindt je Azure Databricks werkruimte met Microsoft Excel en brengt beheerde Lakehouse-data direct in je spreadsheets.
Op deze pagina wordt beschreven hoe u de Azure Databricks Excel-invoegtoepassing gebruikt om gegevens uit Azure Databricks in Excel te importeren en analyseren. U kunt door Azure Databricks-tabellen bladeren en importeren via een intuïtieve interface waar geen SQL-kennis is vereist. Hoewel de invoegtoepassing de flexibiliteit biedt om aangepaste SQL-query's uit te voeren, is deze optioneel.
Voorwaarden
- Voordat u de Excel-invoegtoepassing gebruikt, controleert u of deze is ingesteld.
- U hebt Azure Databricks SQL-toegang en u kunt ten minste DE MACHTIGING GEBRUIKEN voor een SQL-warehouse.
Een SQL Warehouse selecteren
Kies welk SQL Warehouse u wilt gebruiken:
- Klik in de rechterbovenhoek van het Azure Databricks-invoegtoepassingspaneel in Excel op het vervolgkeuzemenu.
- Selecteer welk SQL Warehouse u wilt gebruiken.
Gegevens importeren uit Azure Databricks
Importeer gegevens uit Azure Databricks in Excel door een tabel te selecteren, een SQL-query te schrijven of een draaitabel te importeren.
Note
U kunt metrische weergaven van Unity Catalog importeren met behulp van draaitabellen, SQL-query's en aangepaste functies.
Draaitabellen maken
Een draaitabel maken op basis van Unity Catalog-tabellen en -weergaven in Excel:
Selecteer in het deelvenster Azure Databricks Excel Invoegtoepassing onder het tabblad Nieuw importerenSelecteer gegevens als de Importmethode.
Selecteer onder Catalogus de tabel waaruit u een draaitabel wilt maken en klik op Selecteren.
Schakel het selectievakje Draaigegevens in.
(Optioneel) Selecteer Live query om de query uit te voeren en automatisch een nieuw werkblad bij te werken terwijl je de draaitabel bouwt. Voor meer informatie, zie Live query.
Configureer rij, kolom en waarde door elk veld naar het juiste gebied te slepen.
(Optioneel) Voeg een filter toe. Zie Geïmporteerde gegevens filteren voor meer informatie over filters.
(Optioneel) Stel een rijlimiet in voor uw import.
Importeer uw resultaten. Kies een van de volgende opties:
- Klik op Opslaan en importeren om de query op te slaan voor hergebruik in de Excel-werkmap en importeer de resultaten.
- Klik op de pijl-omlaag en klik vervolgens op Resultaten importeren om de resultaten te importeren zonder de query op te slaan. Gebruik deze optie als u wilt doorgaan met het bewerken van een importbewerking.
Note
Draaitabellen kunnen alleen worden geïmporteerd in een nieuw blad.
Wanneer u met metrische gegevens van Unity Catalog werkt in draaitabellen, wordt Sum(measure) mogelijk weergegeven in de resultaten. Dit is verwacht gedrag en er treedt geen extra aggregatie op. Excel vereist dat waarden een aggregatiefunctie hebben, maar omdat de gegevens unieke waarden bevatten, treedt er geen aggregatie op.
Livequery
Live query voert je pivotquery uit en werkt het werkblad automatisch bij terwijl je het pivot bewerkt, zodat je resultaten ziet wanneer je velden bijwerkt in plaats van nadat je op Importeren hebt geklikt. Live query voert de query opnieuw uit nadat je ten minste één rij of kolom en één waarde hebt veranderd. Om terug te keren naar de standaardstroom, zet je de functie uit.
Wanneer Live query is ingeschakeld, wordt de pivottabel altijd aangemaakt en bijgewerkt in een nieuw sheet. Daarnaast toont de pivotbuilder een knop 'Importeren opslaan ' in plaats van Importeren.
Als Excel sluit terwijl je een live pivot bewerkt, toont het tabblad Imports een hersteloptie zodat je de laatst opgeslagen configuratie voor die import kunt herstellen.
Tabellen selecteren
Gegevens worden geïmporteerd als een Excel-tabelobject. U kunt de tabel verplaatsen of de naam van het blad wijzigen en de Excel-invoegtoepassing vernieuwt gegevens op de nieuwe locatie.
Ga als volgt te werk om gegevens uit een Azure Databricks tabel te importeren:
- Selecteer in het deelvenster Azure Databricks Excel Invoegtoepassing onder het tabblad Nieuw importerenSelecteer gegevens als de Importmethode.
- Kies een tabel die u wilt importeren uit de Catalogusverkenner. U kunt de catalogus filteren op eigenaar, certificeringsstatus en andere eigenschappen met behulp van het
- Klik op Selecteren.
- Klik onder Kolommen op de pijl naar beneden en haal de selectie van de kolommen die u niet wilt importeren weg, of laat alle kolommen geselecteerd als u de hele tabel wilt importeren.
- (Optioneel) Voeg een filter toe. Zie Geïmporteerde gegevens filteren voor meer informatie over filters.
- (Optioneel) Als u een voorbeeld van de import wilt zien, klikt u op Voorbeeld.
- (Optioneel) Stel een rijlimiet in om het aantal geïmporteerde rijen te beperken.
- (Optioneel) Voer een importnaam in om uw geïmporteerde gegevens te identificeren.
- Kies onder Uitvoerbestemming om de gegevens te importeren in een nieuw blad of het huidige blad. Als u naar het huidige blad importeert, beginnen de gegevens bij de celverwijzing die u invoert (standaard A1).
- Importeer uw resultaten. Kies een van de volgende opties:
- Klik op Opslaan en importeren om de query op te slaan voor hergebruik in de Excel-werkmap en importeer de resultaten.
- Klik op de pijl-omlaag en klik vervolgens op Resultaten importeren om de resultaten te importeren zonder de query op te slaan. Gebruik deze optie als u wilt doorgaan met het bewerken van een importbewerking.
SQL-queries schrijven
De importmethode Write SQL ondersteunt SQL-functies en opgeslagen procedures.
Ga als volgt te werk om aangepaste SQL-query's uit te voeren voor uw Azure Databricks-werkruimte:
Selecteer in het deelvenster Excel-invoegtoepassing van Azure Databricks, onder het tabblad Nieuw importeren , SQL schrijven als de importmethode.
Voer een naam in voor uw query om deze later te identificeren.
Schrijf een nieuwe query of gebruik een bestaande query uit uw Azure Databricks-werkruimte.
Schrijf uw SQL-query in de editor. U kunt een query uitvoeren op elke tabel in Unity Catalog waartoe u toegangsmachtigingen hebt.
- Klik op
Catalogusverkenner om uw schema's en tabellen weer te geven.
- Klik op
Als u een query uit uw Azure Databricks werkruimte of een bestaande query in Excel wilt gebruiken, klikt u op
de map. Als u een bestaande query uit uw Azure Databricks-werkruimte gebruikt, worden wijzigingen die zijn aangebracht in Excel, niet doorgevoerd in Azure Databricks.Note
Query's moeten expliciet worden opgeslagen in Azure Databricks met behulp van de knop Opslaan in de rechterbovenhoek van de queryeditor voordat ze worden weergegeven in Excel.
(Optioneel) Als u queryparameters wilt toevoegen, klikt u op +Toevoegen naast Parameters. Klik op de parameter en voer de parameternaam en parameterwaarde in.
- Voor de parameterwaarde kunt u een specifieke waarde invoeren of op het vak en de pijlknop klikken om een celverwijzing op te geven. Selecteer een cel of celbereik en klik op de pijl om de parameterwaarde automatisch te vullen.
Kies onder Uitvoerbestemming om de gegevens te importeren in een nieuw blad of het huidige blad. Als u naar het huidige blad importeert, beginnen de gegevens bij de celverwijzing die u invoert (standaard A1).
Als u een voorbeeld van de queryresultaten wilt bekijken, klikt u op Uitvoeren.
Importeer uw resultaten. Kies een van de volgende opties:
- Klik op Opslaan en importeren om de query op te slaan voor hergebruik in de Excel-werkmap en importeer de resultaten.
- Klik op de pijl-omlaag en klik vervolgens op Resultaten importeren om de resultaten te importeren zonder de query op te slaan. Gebruik deze optie als u wilt doorgaan met het bewerken van een importbewerking.
U kunt ook aangepaste functies gebruiken om queryparameters toe te voegen. Zie SQL schrijven.
Geïmporteerde gegevens filteren
Wanneer u gegevens importeert door een tabel te selecteren of een draaitabel te maken, kunt u filters toepassen om de resultaten te beperken.
Tekenreeksfilters zijn niet hoofdlettergevoelig en worden trapsgewijs toegepast. Wanneer je meer dan één filter toepast, zijn de beschikbare waarden voor elk filter afhankelijk van de selecties in de filters ervoor. Als je bijvoorbeeld filtert op land en vervolgens een filter op stad toevoegt, biedt het stadsfilter alleen steden binnen het geselecteerde land.
Als u filters wilt instellen, klikt u naast +Filters, selecteert u de kolom waarop u een filter wilt toepassen en voert u vervolgens de filtervoorwaarde in. Voor filters waarvoor een waarde is vereist, kunt u een van de volgende handelingen uitvoeren:
- Voer de waarde in.
- Om een lijst van maximaal 5.000 verschillende filterwaarden te genereren, kunt u gebruikmaken:
- Klik op Waarden en vervolgens op Filterwaarden ophalen.
- Klik op de pijl-omlaag en selecteer een of meer waarden in de lijst.
- Een celverwijzing gebruiken:
- Klik op Cellen.
- Selecteer een cel of celbereik.
- Klik op de cursor
van de cursor.
In de volgende tabel worden elk beschikbaar filter en de verwachte invoer beschreven.
| Filter | Verwachte invoer | Description |
|---|---|---|
IS NULL |
Geen | Hiermee vindt u rijen waar de kolomwaarde null is. |
IS NOT NULL |
Geen | Hiermee worden rijen gevonden waarbij de kolomwaarde niet null is. |
EQUALS |
Eén getal of tekenreeks | Zoekt rijen waar de kolomwaarde exact overeenkomt met de opgegeven waarde. |
NOT EQUALS |
Eén getal of tekenreeks | Zoekt rijen waarbij de kolomwaarde niet overeenkomt met de opgegeven waarde. |
STARTS WITH |
Eén tekenreeks | Zoekt rijen waar de kolomwaarde begint met de opgegeven tekst. |
ENDS WITH |
Eén tekenreeks | Zoekt rijen waar de kolomwaarde eindigt op de opgegeven tekst. |
CONTAINS |
Eén tekenreeks | Hiermee worden rijen gevonden waarin de kolomwaarde de opgegeven tekst ergens in de tekenreeks bevat. |
Berekende velden
Een berekend veld is een kolom die is afgeleid van bestaande gegevens, zoals profit berekend vanuit revenue en cost. De Excel-add-in ondersteunt het niet maken van berekende velden met de Select data-importmethode. Om een berekend veld toe te voegen, gebruik je een van de volgende methoden:
- Write SQL: Gebruik de Write SQL-importmethode om berekende kolommen te berekenen met elke SQL-expressie. Zie SQL queries schrijven.
- Genie One: Vraag Genie One om je gegevens terug te sturen met de berekende kolommen die je nodig hebt, en importeer vervolgens de resultaten. Zie Gebruik Genie One in Microsoft Excel.
Databricks raadt aan om Genie One te gebruiken voor berekende velden.
Aangepaste Azure Databricks functies gebruiken in Excel
De Excel-invoegtoepassing biedt aangepaste functies die u in Excel-formules kunt gebruiken om gegevens te importeren uit Azure Databricks.
Een tabel selecteren
Met de DATABRICKS.Table functie worden gegevens geïmporteerd uit een Unity Catalog-tabel.
Syntaxis:
=DATABRICKS.Table(catalog_name.schema_name.table_name, [column1, ...], [limit])
Parameters:
-
catalog_name.schema_name.table_name(vereist): de volledig gekwalificeerde tabelnaam. -
columns(optioneel): Een matrix met kolomnamen die moeten worden geïmporteerd. Laat deze parameter weg om alle kolommen te importeren. -
limit(optioneel): Het maximum aantal rijen dat moet worden geïmporteerd. Laat deze parameter weg om alle rijen te importeren, tot de limiet van 10 MB.
Example:
=DATABRICKS.Table("main.default.customers", {"customer_id", "customer_name"}, 100)
Met deze formule worden de kolom customer_id en kolom customer_name geïmporteerd uit de tabel main.default.customers, beperkt tot 100 rijen.
SQL schrijven
De DATABRICKS.SQL functie voert een SQL-query uit die queryparameters gebruikt en retourneert de resultaten.
Syntaxis:
Geef parameters op met behulp van waarden.
=DATABRICKS.SQL("query_text", {parameter1_name, parameter1_value; ...})
Parameters opgeven met behulp van een celbereik. Definieer de naam- en waardeparameters in cellen die zich in dezelfde rij bevinden.
=DATABRICKS.SQL("query_text", {param_name_cell: param_value_cell; ...})
Parameters:
-
query_text(vereist): de SQL-query die moet worden uitgevoerd. -
parameters(vereist): Een toewijzing van parameterwaarden die in de query moeten worden vervangen.
Example:
=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)
Met deze formule wordt een query uitgevoerd die verkoopgegevens filtert op basis van longitude en latitude, met behulp van de opgegeven parameterwaarden.
Zoekopdrachten beheren
Uw bestaande importbewerkingen beheren vanaf de pagina Import.
Een bestaande importbewerking bewerken
Een bestaande importbewerking bewerken:
- Klik in het deelvenster Azure Databricks-invoegtoepassing in Excel op het tabblad Importeren .
- Zoek de import die u wilt bewerken.
- Klik op het menu met drie punten naast het importeren.
- Klik op Bewerken om uw importbewerking te bewerken.
Gegevens vernieuwen
De Excel-invoegtoepassing vernieuwt gegevens niet automatisch. Hoe u gegevens vernieuwt, is afhankelijk van hoe u deze hebt geïmporteerd. Gegevens die worden geïmporteerd met behulp van een importmethode (een tabel selecteren, een SQL-query schrijven of een draaitabel maken) worden vernieuwd op het tabblad Import . Gegevens die worden geïmporteerd met een aangepaste functie, moeten opnieuw worden berekend.
Importeerbewerkingen bijwerken met de meest recente waarden uit Azure Databricks. De invoegtoepassing voert de oorspronkelijke query of tabelselectie opnieuw uit en werkt het werkblad bij met nieuwe gegevens:
- Eén import verversen:
- Klik in het deelvenster Azure Databricks-invoegtoepassing in Excel op het tabblad Importeren .
- Klik op
naast de import die u wilt vernieuwen.
- Alle imports vernieuwen:
- Klik op Alles vernieuwen in het deelvenster Azure Databricks-invoegtoepassing.
Important
Bij het vernieuwen van gegevens wist de Excel-invoegtoepassing alle bestaande gegevens in de opgegeven tabel en laadt de nieuwste gegevens opnieuw van Azure Databricks. Aangepaste kolommen die u aan de tabel hebt toegevoegd, worden verwijderd tijdens het vernieuwingsproces.
Gegevens die zijn geïmporteerd uit aangepaste functies, zoals DATABRICKS.Table en DATABRICKS.SQL, worden niet vernieuwd wanneer u een werkmap opnieuw opent. Als u gegevens wilt vernieuwen die zijn geïmporteerd uit aangepaste functies, meldt u zich aan bij de invoegtoepassing voor Azure Databricks en berekent u de werkmap opnieuw of wijzigt u een waarde waarnaar de aangepaste functie verwijst.
Gevolgen voor delen
Wanneer u een Excel-werkmap deelt die Azure Databricks-gegevens bevat, moet u rekening houden met de volgende gevolgen voor gegevenstoegang en beveiliging:
Zichtbaarheid van geïmporteerde gegevens
Wanneer een ontvanger een import vernieuwt, gebruikt de invoegtoepassing de machtigingen van de Unity Catalog van de geadresseerde. Als ze geen toegang hebben tot de onderliggende gegevens, mislukt de vernieuwing.
Voor werkmappen waar gegevensprivacy een probleem is, kunt u de volgende tijdelijke oplossing gebruiken:
- Maak een werkmap met alle benodigde formules en importen.
- Verwijder de geïmporteerde gegevens uit het blad.
- Deel de werkmap met de ontvanger.
- Laat de geadresseerde de gegevens vernieuwen.
De ontvanger ziet alleen gegevens waar ze toegang toe hebben op basis van hun Unity Catalog-machtigingen.
Toegang tot werkruimten en gegevensassets
- Gebruikers zonder toegang tot de Unity Catalog-objecten waarnaar in de werkmap wordt verwezen, kunnen de gegevens niet vernieuwen. Als u gegevens wilt vernieuwen, moeten gebruikers leesmachtigingen hebben voor de onderliggende tabellen en weergaven in Unity Catalog.
- Gebruikers moeten toegang hebben tot de onderliggende tabel in Azure Databricks om bestaande importbewerkingen te kunnen bewerken.
Zichtbaarheid van query's
Gebruikers met bewerkingstoegang tot de werkmap kunnen de query's bekijken die worden gebruikt om de gegevens te genereren via de Azure Databricks-invoegtoepassing, zelfs als ze geen toegang hebben tot de onderliggende gegevens in Unity Catalog.
Alternatief voor opslaan als sjabloon
De Azure Databricks Excel-invoegtoepassing biedt geen ondersteuning voor het opslaan van een werkmap als sjabloon, maar u kunt een werkmap delen zodat andere gebruikers de geïmporteerde query's kunnen zien. Zie Gevolgen voor delen voor gegevenstoegang en beveiligingsoverwegingen.
Als tijdelijke oplossing voor het delen van een werkmap als sjabloon voert u een van de volgende handelingen uit:
- Deel het lokale bestand met een andere gebruiker. De ontvanger kan de naam van het bestand wijzigen en de opgeslagen query's bekijken.
- Deel op SharePoint de werkmap met een andere gebruiker. Wanneer een andere gebruiker het bestand downloadt, blijven de opgeslagen importbewerkingen behouden.
Limitations
- Aangepaste functies: voor aangepaste functies zijn queryresultaten beperkt tot 25 MiB vanwege beperkingen van de SQL-uitvoerings-API.
- Gegevens laden: het laden van gegevens kan mislukken als een cel in de werkmap zich in de bewerkingsmodus bevindt.
- Limiet voor Excel-bureaubladrijen: Excel Desktop ondersteunt maximaal 1.048.576 rijen per vel.
- Maximale bestandsgrootte van Excel voor het web: Excel voor het web ondersteunt een maximale bestandsgrootte van ongeveer 25 MB voor het weergeven en bewerken van werkmappen.
- Prestaties van live query: Wanneer Live query is ingeschakeld, voert elke wijziging in de draaitabel een nieuwe query uit op je SQL-warehouse. Resultaten worden niet lokaal gecached, dus frequente bewerkingen op grote pivots kunnen latentie en warehousekosten toevoegen.