Gegevens importeren en er query's op uitvoeren met behulp van de Azure Databricks Excel-invoegtoepassing

De Azure Databricks Excel-invoegtoepassing verbindt uw Azure Databricks werkruimte met Microsoft Excel, waardoor beheerde Lakehouse-gegevens rechtstreeks in uw spreadsheets worden opgenomen, zodat u sneller kunt overstappen van gegevens naar beslissingen.

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 u deze hebt ingesteld.

Een SQL Warehouse selecteren

Kies welk SQL Warehouse u wilt gebruiken:

1. Klik in de rechterbovenhoek van het deelvenster Azure Databricks-invoegtoepassing in het Excel op het dropdownmenu.
2. 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.

Draaitabellen maken

Een draaitabel maken op basis van Unity Catalog-tabellen en -weergaven in Excel:

1. Selecteer in het deelvenster Azure Databricks Excel Invoegtoepassing onder het tabblad Nieuw importerenSelecteer gegevens als de Importmethode.

2. Selecteer onder Catalogus de tabel waaruit u een draaitabel wilt maken en klik op Selecteren.

3. Schakel het selectievakje Draaigegevens in.

4. Configureer indien nodig uw rij, kolom, waarde en filters .

5. (Optioneel) Als u een voorbeeld van de import wilt zien, klikt u op Voorbeeld.

6. (Optioneel) Stel een rijlimiet in voor uw import.

7. 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 de resultaten te importeren.
   • 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.

   Opmerking

   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.

Tabellen selecteren

Gegevens worden geïmporteerd als een Excel-tabel-object. 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:

1. Selecteer in het deelvenster Azure Databricks Excel Invoegtoepassing onder het tabblad Nieuw importerenSelecteer gegevens als de Importmethode.

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

3. Klik op Selecteren.

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

5. (Optioneel) 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. Zie Ondersteunde filters voor een lijst met beschikbare filters.

   Voor filters waarvoor een waarde is vereist, kunt u een van de volgende handelingen uitvoeren:

   • Voer de waarde in.
   • Als u een lijst wilt genereren met maximaal 75 afzonderlijke filterwaarden die u kunt gebruiken, klikt u op Waarden en vervolgens op Filterwaarden ophalen. Klik op de pijl-omlaag en selecteer een of meer waarden in de lijst.
   • Als u een celverwijzing wilt gebruiken, klikt u op Cellen, selecteert u een cel of celbereik en klikt u vervolgens op de cursorknop.

   Opmerking

   Filterwaarden mogen geen komma bevatten. Als u wilt filteren op waarden die komma's bevatten, gebruikt u in plaats daarvan de importmethode Write SQL

6. (Optioneel) Als u een voorbeeld van de import wilt zien, klikt u op Voorbeeld.

7. (Optioneel) U kunt een rijlimiet instellen om het aantal geïmporteerde rijen te beperken.

8. (Optioneel) Als u uw geïmporteerde gegevens eenvoudig wilt identificeren, kunt u een importnaam invoeren.

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

10. 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 de resultaten te importeren.
    • 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.

Ondersteunde filters

Wanneer u gegevens importeert door een tabel te selecteren, kunt u filters toepassen om de resultaten te beperken. In de volgende tabel worden elk beschikbaar filter en de verwachte invoer beschreven.

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 op uw Azure Databricks-werkruimte:

1. Selecteer in het deelvenster Azure Databricks Excel Invoegtoepassing onder het tabblad Nieuw importeren, Write SQL als de importmethode.

2. Voer een naam in voor uw query om deze later te identificeren.

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

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

     Opmerking

     Query's moeten expliciet worden opgeslagen in Azure Databricks met behulp van de knop Save in de query-editor voordat ze worden weergegeven in Excel.

4. (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.

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

6. Als u een voorbeeld van de queryresultaten wilt bekijken, klikt u op Uitvoeren.

7. 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 de resultaten te importeren.
   • 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.

Aangepaste functies gebruiken in Excel

De Excel-invoegtoepassing biedt aangepaste functies die u in Excel formules kunt gebruiken om gegevens uit Azure Databricks te importeren.

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.

Voorbeeld:

=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. De naam- en waardeparameters moeten worden gedefinieerd 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.

Voorbeeld:

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

Queries beheren

Uw bestaande importbewerkingen beheren vanaf de pagina Import.

Een bestaande importbewerking bewerken

Een bestaande importbewerking bewerken:

1. Klik in het deelvenster Azure Databricks Invoegtoepassing in Excel op het tabblad Imports.
2. Zoek de import die u wilt bewerken.
3. Klik op het menu met drie punten naast het importeren.
4. Klik op Bewerken om uw importbewerking te bewerken.

Gegevens vernieuwen

De Excel-invoegtoepassing vernieuwt geïmporteerde gegevens niet automatisch. Uw gegevens bijwerken met de meest recente waarden uit Azure Databricks:

• Ga als volgt te werk om één importbewerking bij te werken:
  1. Klik in het deelvenster Azure Databricks Invoegtoepassing in Excel op het tabblad Imports.
  2. Klik op naast de import die u wilt vernieuwen.
• Ga als volgt te werk om alle importbewerkingen te vernieuwen:
  1. Klik op Refresh All in het deelvenster Azure Databricks-invoegtoepassing.

De invoegtoepassing voert de oorspronkelijke query of tabelselectie opnieuw uit en werkt het werkblad bij met nieuwe gegevens.

Gevolgen voor delen

Wanneer u een Excel werkmap met Azure Databricks gegevens deelt, 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:

1. Maak een werkmap met alle benodigde formules en importen.
2. Verwijder de geïmporteerde gegevens uit het blad.
3. Deel de werkmap met de ontvanger.
4. 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.

Beperkingen

• 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.
• Excel Rijlimiet voor bureaublad: Excel Desktop ondersteunt maximaal 1.048.576 rijen per vel.
• webversie van Excel maximale bestandsgrootte: webversie van Excel ondersteunt een maximale werkmapbestandsgrootte van ongeveer 25 MB voor weergave en bewerking.