Automatische Datenauffrischung im Azure Databricks Excel Add-in planen

Die geplante Aktualisierung hält die in ein Excel-Arbeitsbuch importierten Daten auf dem neuesten Stand, indem der Import automatisch in einem Zeitplan ausgeführt wird. Sie können einen Zeitplan für eine gespeicherte Abfrage, eine Tabelle oder eine Pivot-Tabelle erstellen, das SQL-Warehouse auswählen, das jede Aktualisierung ausführt, und die letzten Ausführungen aus dem Azure Databricks Excel-Add-In überprüfen.

Prerequisites

Bevor Sie eine geplante Aktualisierung erstellen, stellen Sie sicher, dass:

• Das Arbeitsbuch wird in Microsoft OneDrive oder SharePoint gespeichert.
• Die Abfrage, Tabelle oder Pivot-Tabelle ist bereits importiert und erscheint unter Gespeicherte Importe. Siehe Daten importieren und abfragen mit dem Azure Databricks Excel-Add-in.
• Sie verfügen über die Berechtigung, das SQL-Warehouse zu verwenden, das die Aktualisierung ausführt.
• Dein Microsoft-Konto ist mit dem Azure Databricks Excel-Add-in verbunden. Siehe Set up the Azure Databricks Excel Add-In.

Geplante Aktualisierungen werden mit der Azure Databricks-Identität und den Microsoft-Zugangsdaten der Person, die den Zeitplan erstellt, durchgeführt. Halten Sie diese Zugangsdaten aktiv, damit Azure Databricks die Daten abfragen und das Arbeitsbuch aktualisieren kann.

Microsoft-Berechtigungen

Ihre Excel-Add-In-Datei muss die folgende Domain im AppDomains Abschnitt enthalten. Wenn Sie das Excel-Add-In installiert haben, bevor die geplante Aktualisierung veröffentlicht wurde, fügen Sie die Domain in Ihre Add-In-Datei ein oder laden Sie die Datei erneut herunter. Siehe Set up the Azure Databricks Excel Add-In.

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

Das Add-In fordert folgende Microsoft-Berechtigungen an, denen Sie für eine geplante Aktualisierung zustimmen müssen, um auf die Arbeitsmappe zuzugreifen und die Arbeitsmappe zu aktualisieren:

• Files.ReadWrite: Lesen Sie Ihre Arbeitsmappe und aktualisieren Sie sie.
• offline_access: Lassen Sie geplante Aktualisierungen laufen, wenn Sie nicht aktiv angemeldet sind.

Einen Zeitplan erstellen

Erstellen Sie eine geplante Aktualisierung für jede gespeicherte Abfrage, Tabelle oder Pivot-Tabelle aus dem Azure Databricks Excel Add-In.

1. Öffnen Sie das Azure Databricks Excel Add-In.
2. Gehen Sie zu Gespeicherte Importe.
3. Suchen Sie den Import, den Sie automatisch aktualisieren möchten.
4. Wählen Sie die Kalender-Schaltfläche neben dem Import aus.
5. Überprüfen Sie Ressourcendetails, um sicherzustellen, dass Sie die richtige Abfrage, Tabelle oder Pivot-Tabelle ausgewählt haben.
6. Geben Sie im Reiter Zeitplan verwalten einen beschreibenden Zeitplannamen ein.
7. Wählen Sie einen Zeitplantyp. Siehe Intervall und Zeitplan:
   • Intervall: Aktualisierung alle angegebenen Minuten, Stunden, Tage oder Wochen.
   • Zeitplan: Wählen Sie einen kalenderbasierten Rhythmus und ein Zeit aus, zum Beispiel jeden Tag zu einer bestimmten Zeit oder jede Woche an einem bestimmten Tag.
8. Wenn Sie Zeitplan ausgewählt haben, bestätigen Sie die Zeitzone. Die ursprüngliche Zeitzone basiert auf den lokalen Einstellungen Ihres Browsers.
9. Wählen Sie unter SQL Warehouse das Warehouse aus, das die Abfrage ausführt.
10. Wählen Sie Zeitplan erstellen aus.

Nachdem der Zeitplan erstellt wurde, ändert sich die Kalenderschaltfläche des gespeicherten Imports in ein Kalendersymbol mit Uhr.

Intervall

Wählen Sie Intervall, wenn die Aktualisierung nach einer normalen Phase wiederholt werden sollte. Geben Sie eine Zahl ein und wählen Sie Minuten, Stunden, Tage oder Wochen aus.

Die verfügbaren Intervallbereiche sind:

• 1 bis 120 Minuten
• 1 bis 72 Stunden
• 1 bis 31 Tage
• 1 bis 8 Wochen

Für eine Aktualisierung, die an einem bestimmten Wochentag und zu einer bestimmten Uhrzeit ausgeführt werden muss, verwenden Sie Zeitplan anstelle eines wöchentlichen Intervalls.

Zeitplan

Verwenden Sie Zeitplan, wenn die Aktualisierung zu einem bestimmten Kalenderzeitpunkt ausgeführt werden muss. Je nach Rhythmus können Sie auswählen:

• Die Häufigkeit, z. B. Minute, Stunde, Tag, Woche oder Monat
• die Tageszeit
• Der Wochentag für Wochenpläne
• Der Tag des Monats für die Monatspläne
• Die Zeitzone

Die Zeiten werden in der Zeitzone des ausgewählten Zeitplans ausgewertet. Zeitstempel des Ausführungsverlaufs werden anhand der Locale des Betrachters angezeigt.

Aktualisieren Sie einen bestehenden Zeitplan

Ändere den Namen, den Rhythmus, die Zeitzone oder das SQL-Warehouse eines bereits erstellten Zeitplans.

1. Wählen Sie bei gespeicherten Importen den Kalender-mit-Uhr-Button für den Import aus.
2. Ändern Sie auf der Registerkarte Zeitplan verwalten den Namen des Zeitplans, den Rhythmus, die Zeitzone oder das SQL-Warehouse.
3. Wählen Sie Zeitplan aktualisieren aus.

Das Aktualisieren des zugrundeliegenden gespeicherten Imports synchronisiert auch dessen Abfrage, Parameter, Filter und Zeilenlimit mit der geplanten Aktualisierung. Der nächste Durchlauf verwendet die aktualisierte Import-Definition.

Verlauf des Review-Laufs

Überprüfen Sie das Ergebnis der letzten Aktualisierungsdurchläufe für einen geplanten Import, einschließlich des Status, der Dauer und etwaiger Fehlerdetails jedes Durchlaufs.

1. Öffnen Sie den Zeitplan für den gespeicherten Import.
2. Wählen Sie die Registerkarte Ausführungsverlauf.
3. Sehen Sie sich die neuesten Ausführungen an. Jeder Eintrag zeigt seine Abschlusszeit, Status und Dauer an.
4. Klappen Sie eine Ausführung auf, um weitere Details anzuzeigen, darunter auch eine Fehlermeldung, wenn eine Aktualisierung fehlschlägt.

Zu den Ausführungsstatus gehören:

• OK: Die Aktualisierung wurde erfolgreich abgeschlossen.
• Wird ausgeführt: Die Aktualisierung ist noch im Gange.
• Fehlgeschlagen: Die Aktualisierung wurde nicht abgeschlossen. Erweitern Sie die Ausführung, um die verfügbaren Fehlerdetails anzuzeigen.

Wenn der Zeitplan noch nicht ausgeführt wurde, zeigt die Registerkarte Noch kein Ausführungsverlauf an.

Geplanten Import löschen

Geplante Aktualisierung bietet keine separate Option, einen Zeitplan zu pausieren oder nur den Zeitplan zu löschen.

Um den Zeitplan im Excel-Add-in zu stoppen, löschen Sie den gespeicherten Import:

1. Öffnen Sie unter Gespeicherte Importe das Aktionsmenü für den Import.
2. Klicken Sie auf Löschen.

Das Löschen des gespeicherten Imports löscht auch den zugehörigen geplanten Aktualisierungsauftrag und entfernt die gespeicherte Importkonfiguration aus der Arbeitsmappe.

Problembehandlung

Wenn eine geplante Aktualisierung nicht ausgeführt wird oder die Arbeitsmappe nicht aktualisiert wird, verwenden Sie die folgenden Abschnitte, um die häufigsten Ursachen zu identifizieren und zu beheben.

Deine Microsoft-Anmeldeinformationen sind abgelaufen

Die geplante Aktualisierung erfordert den Zugriff auf die Arbeitsmappe über Ihr Microsoft-Konto. Wenn das Add-in folgende Meldung anzeigt, sind Ihre Zugangsdaten abgelaufen:

Ihre Microsoft-Anmeldeinformationen sind abgelaufen. Melden Sie sich an, damit geplante Aktualisierungen weiterhin ausgeführt werden.

Wählen Sie Microsoft-Anmeldung aus und schließen Sie den Anmeldevorgang ab. Ein Zeitplan kann weiterhin konfiguriert erscheinen, während die Zugangsdaten abgelaufen sind, aber Aktualisierungsläufe können das Arbeitsbuch nicht aktualisieren, bis der Zugriff wiederhergestellt ist.

Eine geplante Aktualisierung schlägt fehl

Wenn ein Durchlauf den Status Fehlgeschlagen aufweist, arbeiten Sie die folgenden Prüfungen durch, um die Ursache zu ermitteln:

1. Öffnen Sie den Zeitplan und wählen Sie Ausführungsverlauf.
2. Erweitern Sie die fehlgeschlagene Ausführung und überprüfen Sie die Fehlermeldung.
3. Bestätigen Sie, dass Ihr Microsoft Account noch verbunden ist.
4. Bestätigen Sie, dass die Arbeitsmappe noch in OneDrive oder SharePoint vorhanden ist und Ihr Konto sie bearbeiten kann.
5. Bestätigen Sie, dass das ausgewählte SQL-Warehouse verfügbar ist und dass Sie die Quellabfrage ausführen können.
6. Bestätigen Sie, dass Sie noch Zugriff auf die Quelltabelle und andere referenzierte Daten haben.
7. Wenn der Import für Parameter oder Filter Excel-Zellbezüge verwendet, vergewissern Sie sich, dass das referenzierte Tabellenblatt und die entsprechenden Zellen noch vorhanden sind.

Die Arbeitsmappe wird nicht aktualisiert

Wenn Ausführungen als erfolgreich gemeldet werden, die Arbeitsmappendaten jedoch veraltet sind, vergewissern Sie sich, dass sich die Arbeitsmappe noch am erwarteten Speicherort befindet und zugänglich ist:

1. Öffnen Sie die Arbeitsmappe von ihrem OneDrive- oder SharePoint-Speicherort.
2. Bestätigen Sie, dass die Arbeitsmappe seit der letzten Aktualisierung des Zeitplans nicht verschoben, umbenannt oder ersetzt wurde.
3. Stelle die Verbindung mit deinem Microsoft-Konto erneut her, wenn du dazu aufgefordert wirst.
4. Überprüfen Sie den Laufverlauf auf den neuesten Status und die Fehlerdetails.