Plan automatische gegevensverversing in de Azure Databricks Excel Add-in

Geplande verversing houdt gegevens die in een Excel-werkboek worden geïmporteerd up-to-date door de import automatisch op een schema uit te voeren. Je kunt een schema maken voor een opgeslagen query, tabel- of draaitabelimport, het SQL-warehouse kiezen dat elke verversing uitvoert, en recente runs uit de Azure Databricks Excel Add-in bekijken.

Prerequisites

Voordat je een geplande verversing maakt, zorg ervoor dat:

• Het werkboek wordt opgeslagen in Microsoft OneDrive of SharePoint.
• De query, tabel of draaitabel is al geïmporteerd en verschijnt onder Opgeslagen imports. Zie Importeren en gegevens opvragen met de Azure Databricks Excel Add-in.
• Je hebt toestemming om het SQL-warehouse te gebruiken dat wordt gebruikt om de verversing uit te voeren.
• Je Microsoft-account is verbonden met de Azure Databricks Excel Add-in. Zie Set up the Azure Databricks Excel Add-in.

Geplande verversingen worden uitgevoerd met de Azure Databricks-identiteit en Microsoft-inloggegevens van de persoon die het schema aanmaakt. Houd die inloggegevens actief zodat Azure Databricks de gegevens kan opvragen en het werkboek kan bijwerken.

Microsoft-machtigingen

Je Excel Add-in bestand moet het volgende domein in de AppDomains sectie bevatten. Als je de Excel-add-in hebt geïnstalleerd voordat de geplande verversing werd uitgebracht, voeg dan het domein toe aan je add-in bestand of download het bestand opnieuw. Zie Set up the Azure Databricks Excel Add-in.

<AppDomain>https://login.microsoftonline.com</AppDomain>

De Add-in vraagt de volgende Microsoft-rechten, waarvoor je moet instemmen voor een geplande verversing om toegang te krijgen tot en het werkboek te kunnen bijwerken:

• Files.ReadWrite: Lees en werk je werkboek bij.
• offline_access: Houd geplande verversingen draaien wanneer je niet actief bent ingelogd.

Een planning maken

Maak een geplande verversing aan voor elke opgeslagen query, tabel of pivottabel import vanuit de Azure Databricks Excel Add-in.

1. Open de Azure Databricks Excel Add-in.
2. Ga naar Opgeslagen imports.
3. Zoek de import die je automatisch wilt verversen.
4. Selecteer de agendaknop naast de import.
5. Bekijk de Asset Details om te bevestigen dat je de juiste query, tabel of pivottabel hebt gekozen.
6. Voer op het tabblad Planning beheren een beschrijvende Planningsnaam in.
7. Kies een type rooster. Zie Interval en Schema:
   • Interval: Vernieuw elk opgegeven aantal minuten, uren, dagen of weken.
   • Schema: Kies een kalendergebaseerd ritme en tijdstip, bijvoorbeeld elke dag op een specifiek tijdstip of elke week op een specifieke dag.
8. Als je Planning hebt geselecteerd, bevestig dan de tijdzone. De initiële tijdzone is gebaseerd op de instellingen van je lokale browser.
9. Selecteer onder SQL Warehouse het warehouse dat de query uitvoert.
10. Selecteer Schema aanmaken.

Nadat het schema is aangemaakt, verandert de agendaknop voor de opgeslagen import naar een kalender-met-klok-icoon.

Tijdsegment

Gebruik Interval wanneer de verversing na een reguliere periode moet worden herhaald. Voer een nummer in en selecteer minuten, uren, dagen of weken.

De beschikbare intervalbereiken zijn:

• 1 tot 120 minuten
• 1 tot 72 uur
• 1 tot 31 dagen
• 1 tot 8 weken

Voor een refresh die op een specifieke doordeweekse dag en tijd moet plaatsvinden, gebruik Schedule in plaats van een wekelijks interval.

Schedule

Gebruik Schedule wanneer de verversing op een specifiek kalendertijdstip moet draaien. Afhankelijk van het ritme kun je kiezen:

• De frequentie, zoals een minuut, een uur, een dag, een week of een maand
• Het tijdstip van de dag
• De weekdag voor wekelijkse schema's
• De dag van de maand voor maandelijkse schema's
• De tijdzone

Tijden worden beoordeeld in de geselecteerde tijdzone van het schema. Tijdstempels van de loopgeschiedenis worden weergegeven op basis van de locatie van de kijker.

Werk een bestaand schema bij

Verander de naam, ritme, tijdzone of SQL-warehouse van een schema dat je al hebt aangemaakt.

1. Selecteer bij Opgeslagen importen de knop met kalender voor de import.
2. Verander in het tabblad Schedule beheren de naam van het schema, de cadens, de tijdzone of het SQL-warehouse.
3. Selecteer Updateschema.

Het bijwerken van de onderliggende opgeslagen import synchroniseert ook de query, parameters, filters en rijlimiet met de geplande verversing. De volgende run gebruikt de bijgewerkte importdefinitie.

Geschiedenis van de uitzendingen

Controleer de uitkomst van recente refresh-runs voor een geplande import, inclusief de status, duur en eventuele foutdetails van elke run.

1. Open het schema voor de opgeslagen import.
2. Selecteer het tabblad Run history .
3. Bekijk de recente runs. Elke vermelding toont de voltooiingstijd, status en duur.
4. Vouw een run uit om meer details te zien, inclusief een foutmelding wanneer een verversing mislukt.

Run-statussen zijn onder andere:

• OK: De verversing is succesvol voltooid.
• Lopen: De vernieuwing is nog steeds in uitvoering.
• Mislukt: De verversing is niet voltooid. Vouw de run uit om de beschikbare foutdetails te bekijken.

Als het schema nog niet is uitgevoerd, toont het tabblad Geen loopgeschiedenis nog.

Verwijder een geplande import

Geplande verversing biedt geen aparte optie om een schema te pauzeren of alleen het schema te verwijderen.

Om het schema vanuit de Excel-invoegtoepassing te beëindigen, verwijder je de opgeslagen import:

1. Open in Opgeslagen importen het actiemenu van de import.
2. Selecteer Verwijderen.

Het verwijderen van de opgeslagen import verwijdert ook de bijbehorende geplande ververstaak en verwijdert de opgeslagen importconfiguratie uit het werkboek.

Troubleshooting

Als een geplande verversing niet plaatsvindt of het werkboek niet wordt bijgewerkt, raadpleeg dan de volgende secties om de meest voorkomende oorzaken vast te stellen en op te lossen.

Je Microsoft-inloggegevens zijn verlopen

Geplande verversing vereist toegang tot het werkboek via je Microsoft-account. Als de Add-in het volgende bericht weergeeft, zijn je inloggegevens verlopen:

Je Microsoft-inloggegevens zijn verlopen. Log in om geplande verversingen draaiende te houden.

Selecteer Microsoft-login en voltooi de aanmeldstroom. Een schema kan nog steeds geconfigureerd verschijnen terwijl de inloggegevens verlopen zijn, maar verversingsuitvoeringen kunnen het werkboek pas bijwerken als de toegang is hersteld.

Een geplande verversing faalt

Als een run een status Mislukt vertoont, doorloop dan de volgende controles om de oorzaak te identificeren:

1. Open het schema en selecteer Uitvoeringsgeschiedenis.
2. Vouw de mislukte uitvoering uit en bekijk de foutmelding.
3. Controleer of je Microsoft-account nog steeds verbonden is.
4. Bevestig dat het werkboek nog steeds bestaat in OneDrive of SharePoint en dat je account het kan bewerken.
5. Bevestig dat het geselecteerde SQL-warehouse beschikbaar is en dat je de bronquery kunt uitvoeren.
6. Bevestig dat je nog steeds toegang hebt tot de brontabel en andere gerefereerde gegevens.
7. Als de import Excel-celreferenties gebruikt voor parameters of filters, controleer dan of het referentiewerkblad en de cellen nog bestaan.

De werkmap wordt niet bijgewerkt

Als het wordt uitgevoerd, rapporteer succes maar de gegevens van het werkboek zijn verouderd, bevestig dan dat het werkboek nog steeds op de verwachte locatie en toegankelijk is:

1. Open het werkboek vanaf de locatie in OneDrive of SharePoint.
2. Bevestig dat de werkmap niet is verplaatst, hernoemd of vervangen sinds de planning voor het laatst is bijgewerkt.
3. Maak opnieuw verbinding met je Microsoft-account als je daarom vraagt.
4. Bekijk de rungeschiedenis voor de laatste status en foutgegevens.