Zaplanuj automatyczne odświeżanie danych w dodatku Azure Databricks Excel

Planowane odświeżanie utrzymuje dane importowane do zeszytu Excel aktualnym, uruchamiając import automatycznie według harmonogramu. Możesz stworzyć harmonogram dla importu zapisanego zapytania, tabeli lub tabeli przestawnej, wybrać magazyn SQL, który uruchamia każde odświeżanie, i przeglądać ostatnie uruchomienia z dodatku Azure Databricks Excel.

Aby dowiedzieć się, jak planowane odświeżanie łączy się z Microsoft 365 oraz które funkcje bezpieczeństwa sieciowego mają zastosowanie, zobacz Architektura i zabezpieczenia dodatku Excel Azure Databricks.

Prerequisites

Zanim utworzysz zaplanowane odświeżenie, upewnij się, że:

• Skoroszyt jest zapisany w Microsoft OneDrive lub SharePoint.
• Zapytanie, tabela lub tabela przestawna są już zaimportowane i pojawiają się w sekcji Zapisane importy. Zobacz Import i zapytania o dane za pomocą dodatku Azure Databricks Excel.
• Masz uprawnienia do korzystania z magazynu SQL, który uruchamia odświeżanie.
• Twój konto Microsoft jest powiązany z dodatkiem Azure Databricks Excel. Zobacz Konfigurowanie dodatku Azure Databricks Excel.

Zaplanowane odświeżenia są uruchamiane przy użyciu tożsamości Azure Databricks oraz poświadczeń Microsoft osoby, która tworzy harmonogram. Utrzymuj te dane poświadczenia aktywne, aby Azure Databricks mógł zapytać o dane i aktualizować zeszyt.

Uprawnienia firmy Microsoft

Twój plik dodatków Excel musi zawierać następującą domenę w AppDomains tej sekcji. Jeśli zainstalowano dodatek programu Excel, zanim udostępniono funkcję zaplanowanego odświeżania, dodaj domenę do pliku dodatku lub pobierz plik ponownie. Zobacz Konfigurowanie dodatku Azure Databricks Excel.

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

Dodatek prosi o następujące uprawnienia Microsoft, na które musisz wyrazić zgodę na zaplanowane odświeżanie, aby uzyskać dostęp i zaktualizować zeszyt:

• Files.ReadWrite: Przeczytaj i zaktualizuj swój zeszyt ćwiczeń.
• offline_access: Utrzymuj zaplanowane odświeżenia, gdy nie jesteś aktywnie zalogowany.

Tworzenie harmonogramu

Utwórz zaplanowane odświeżanie dla każdego zapisanego zapytania, tabeli lub tabeli przestawnej zaimportowanych za pomocą dodatku Azure Databricks do programu Excel.

1. Otwórz dodatek Azure Databricks Excel.
2. Przejdź do Zapisanych importów.
3. Znajdź import, który chcesz odświeżyć automatycznie.
4. Wybierz przycisk kalendarza obok importu.
5. Sprawdź szczegóły zasobów , aby upewnić się, że wybrałeś właściwe zapytanie, tabelę lub tabelę przestawną.
6. Na zakładce Zarządzaj harmonogramem wpisz opisową nazwę harmonogramu.
7. Wybierz typ harmonogramu. Zobacz interwał i harmonogram:
   • Częstotliwość: Odświeżaj co określoną liczbę minut, godzin, dni lub tygodni.
   • Harmonogram: Wybierz rytm i czas oparty na kalendarzu, na przykład każdego dnia o określonej porze lub co tydzień w określonym dniu.
8. Jeśli wybrałeś Harmonogram, potwierdź strefę czasową. Początkowa strefa czasowa jest ustawiana na podstawie lokalnych ustawień przeglądarki.
9. W SQL Warehouse wybierz magazyn, który uruchamia zapytanie.
10. Wybierz Utwórz harmonogram.

Po utworzeniu harmonogramu przycisk kalendarza dla zapisanego importu zmienia się w ikonę kalendarza z zegarem.

Odstęp

Używaj Intervalu , gdy odświeżanie powinno się powtórzyć po regularnym czasie. Wpisz liczbę i wybierz minuty, godziny, dni lub tygodnie.

Dostępne zakresy interwałów to:

• od 1 do 120 minut
• 1 do 72 godzin
• 1 do 31 dni
• Od 1 do 8 tygodni

Aby odświeżyć program, który musi działać w określony dzień i godzinę tygodnia, użyj Harmonogramu zamiast tygodniowego interwału.

Schedule

Użyj Schedule, gdy odświeżanie musi być przeprowadzone o określonej godzinie kalendarza. W zależności od kadencji możesz wybrać:

• Częstotliwość, taka jak minuta, godzina, dzień, tydzień lub miesiąc
• Pora dnia
• Dzień tygodnia w harmonogramach tygodniowych
• Dzień miesiąca dla miesięcznych harmonogramów
• Strefa czasowa

Godziny są obliczane w wybranej strefie czasowej harmonogramu. Znaczniki czasu historii uruchomienia są wyświetlane na podstawie lokalizacji widza.

Zaktualizuj istniejący harmonogram

Zmień nazwę, częstotliwość, strefę czasową lub hurtownię SQL w już utworzonym harmonogramie.

1. W Zapisanych importach wybierz przycisk kalendarz z zegarem do importu.
2. Na zakładce Zarządzanie harmonogramem zmień nazwę harmonogramu, rytm, strefę czasową lub magazyn SQL.
3. Wybierz Harmonogram aktualizacji.

Aktualizacja bazowego zapisanego importu powoduje również synchronizację jego zapytania, parametrów, filtrów i limitu wierszy z zaplanowanym odświeżaniem. Następny przebieg wykorzystuje zaktualizowaną definicję importu.

Historia uruchomień

Sprawdź wyniki ostatnich uruchomień odświeżania dla zaplanowanego importu, w tym stan każdego uruchomienia, czas jego trwania oraz szczegóły ewentualnych błędów.

1. Otwórz harmonogram zapisu importu.
2. Wybierz zakładkę Historia biegów .
3. Przejrzyj ostatnie serie. Każdy wpis pokazuje czas ukończenia, status i czas trwania.
4. Rozwiń przebieg, aby zobaczyć więcej szczegółów, w tym komunikat o błędzie po niepowodzeniu odświeżenia.

Statusy run obejmują:

• OK: Odświeżenie zakończyło się pomyślnie.
• W toku: Odświeżenie wciąż trwa.
• Niepowodzenie: Odświeżanie nie zostało ukończone. Rozwiń przebieg, aby zobaczyć dostępne szczegóły awarii.

Jeśli harmonogram jeszcze się nie ukończył, zakładka wyświetla Brak historii przebiegów.

Usuń zaplanowany import

Planowane odświeżanie nie daje osobnej opcji wstrzymania harmonogramu lub usunięcia tylko harmonogramu.

Aby zatrzymać harmonogram w dodatku programu Excel, usuń zapisany import:

1. W sekcji Zapisane importy otwórz menu akcji dla importu.
2. Wybierz Usuń.

Usunięcie zapisanego importu usuwa również powiązane zadanie zaplanowanego odświeżania i usuwa zapisaną konfigurację importu z podręcznika.

Troubleshooting

Jeśli zaplanowane odświeżenie nie zostanie wykonane lub skoroszyt nie zostanie zaktualizowany, skorzystaj z poniższych sekcji, aby zidentyfikować najczęstsze przyczyny i rozwiązać związane z nimi problemy.

Twoje dane Microsoft wygasły

Zaplanowane odświeżanie wymaga dostępu do skoroszytu za pośrednictwem konta Microsoft. Jeśli dodatek wyświetla następujący komunikat, Twoje dane uwierzytelniające wygasły:

Poświadczenia konta Microsoft wygasły. Zaloguj się, aby zaplanowane odświeżanie nadal działało.

Wybierz logowanie Microsoft i przejdź przez proces logowania. Harmonogram może nadal wyglądać na skonfigurowany, nawet jeśli poświadczenia wygasły, ale uruchomienia odświeżania nie mogą aktualizować skoroszytu, dopóki dostęp nie zostanie przywrócony.

Zaplanowane odświeżanie nie powodzi się

Jeśli uruchomienie ma stan Nieudany, wykonaj następujące sprawdzenia, aby ustalić przyczynę:

1. Otwórz harmonogram i wybierz Historia uruchomień.
2. Rozwiń nieudany przebieg i przejrzyj komunikat o błędzie.
3. Potwierdź, że Twoje konto Microsoft jest nadal połączone.
4. Potwierdź, że skoroszyt nadal istnieje w usłudze OneDrive lub SharePoint oraz że Twoje konto może go edytować.
5. Potwierdź, że wybrana magazynowa SQL jest dostępna i czy możesz uruchomić zapytanie źródłowe.
6. Potwierdź, że nadal masz dostęp do tabeli źródłowej i innych danych, do których się odwołano.
7. Jeśli import używa odwołań do komórek programu Excel jako parametrów lub filtrów, upewnij się, że wskazany arkusz i komórki nadal istnieją.

Zeszyt ćwiczeń nie jest aktualizowany

Jeśli uruchomienia kończą się powodzeniem, ale dane skoroszytu są nieaktualne, upewnij się, że skoroszyt nadal znajduje się w oczekiwanym miejscu i jest dostępny:

1. Otwórz skoroszyt z lokalizacji w usłudze OneDrive lub SharePoint.
2. Potwierdź, że zeszyt ćwiczeń nie został przeniesiony, przemianowany ani wymieniony od czasu ostatniej aktualizacji harmonogramu.
3. Podłącz ponownie swoje konto Microsoft, jeśli zostanie o to poproszony.
4. Sprawdź historię uruchomień po najnowszy status i szczegóły błędów.