Planowanie odświeżania danych w arkuszach Google

Na tej stronie opisano sposób planowania automatycznych odświeżeń danych w łączniku usługi Databricks dla arkuszy Google w celu zapewnienia aktualności zaimportowanych danych. Zaplanowane odświeżenia uruchamiają zapisane zapytania cyklicznie i aktualizują odpowiednie arkusze.

Wymagania

Utwórz połączenie Unity Catalog

Zaplanowane odświeżanie wymaga następujących elementów:

  • Połączenie Unity Catalog o nazwie databricks_google_connection, utworzone przez administratora metamagażynu w Arkuszach Google.
  • Uprawnienie USE CONNECTION do połączenia przyznane użytkownikom, którzy muszą tworzyć lub zarządzać zaplanowanymi odświeżeniami.
  1. Jako administrator magazynu metadanych Azure Databricks w arkuszach Google otwórz pasek boczny Łącznik usługi Databricks dla arkuszy Google.
  2. Kliknij kartę Zapisane importy .
  3. Kliknij kalendarz w prawym górnym rogu.
  4. Kliknij pozycję Skonfiguruj połączenie.

Udostępnianie połączenia w Azure Databricks

Po utworzeniu połączenia przyznaj użytkownikom uprawnienia USE CONNECTION, którzy muszą tworzyć lub zarządzać zaplanowanymi odświeżeniami. Administrator magazynu metadanych lub dowolny użytkownik z MANAGE uprawnieniami do połączenia może przyznać to uprawnienie. Aby uzyskać więcej informacji na temat zarządzania połączeniami, zobacz Zarządzanie połączeniami dla federacji Lakehouse.

Tworzenie harmonogramu

Każdy import można przypisać tylko do jednego harmonogramu. Aby utworzyć nowy harmonogram dla istniejącego importu:

  1. Na pasku bocznym łącznika Azure Databricks w arkuszach Google kliknij kartę Zapisane importy.

  2. Kliknij ikonę kalendarza i kliknij pozycję Nowy harmonogram.

  3. Wybierz import danych, dla którego chcesz utworzyć harmonogram.

  4. Wprowadź nazwę harmonogramu.

  5. Wybierz częstotliwość harmonogramu:

    • W obszarze Godzinowe wybierz minutę godziny, aby uruchomić odświeżanie.
    • W obszarze Codziennie wybierz godzinę dnia, aby uruchomić odświeżanie.
    • W obszarze Co tydzień wybierz dzień tygodnia i godzinę uruchomienia odświeżania.

    Harmonogram używa lokalnej strefy czasowej.

  6. Wybierz usługę SQL Warehouse do użycia dla zaplanowanych zapytań.

  7. Kliknij pozycję Utwórz harmonogram.

Wyświetl historię uruchomień i szczegóły harmonogramu

Aby wyświetlić historię uruchamiania wszystkich zaplanowanych odświeżeń, wykonaj następujące czynności:

  1. Na pasku bocznym łącznika Azure Databricks w arkuszach Google kliknij kartę Zapisane importy.
  2. Kliknij ikonę kalendarza i kliknij pozycję Wyświetl historię uruchomień.
  3. Kliknij wybrane uruchomienie, aby wyświetlić szczegóły harmonogramu.

Aby wyświetlić historię uruchamiania i szczegóły konfiguracji zaplanowanego odświeżania, wykonaj następujące czynności:

  1. W okienku Wyświetl historię uruchamiania wybierz nazwę harmonogramu, który chcesz wyświetlić. W sekcji Ostatnie uruchomienia wyświetlany jest status każdego uruchomienia.

  2. Zatrzymaj wskaźnik myszy na ikonie stanu, aby wyświetlić identyfikator przebiegu, godzinę rozpoczęcia i stan uruchomienia.

    Najedź kursorem na ikonę stanu uruchomienia w sekcji Ostatnie uruchomienia, aby wyświetlić szczegóły danego uruchomienia

  3. Kliknij pozycję Wyświetl konfigurację , aby wyświetlić szczegóły harmonogramu, które obejmują wybraną konfigurację importu i harmonogramu.

    • Jeśli wyświetlasz harmonogram utworzony przez inną osobę, wyświetlany czas to czas w lokalnej strefie czasowej twórcy.

Usuń zaplanowane odświeżanie

Aby usunąć zaplanowane odświeżanie, wykonaj następujące czynności:

  1. Na pasku bocznym łącznika Azure Databricks w arkuszach Google kliknij kartę Zapisane importy.
  2. Kliknij ikonę kalendarza i kliknij pozycję Zarządzaj harmonogramami.
  3. Wybierz harmonogram, który chcesz usunąć.
  4. Kliknij pozycję Wyświetl konfigurację, a następnie kliknij pozycję Usuń.

Troubleshooting

W przypadku błędu wygasłego lub cofniętego tokena zobacz Planowane odświeżenie nie powiodło się, ponieważ token Google wygasł lub został cofnięty.

W przypadku innych problemów z zaplanowanymi odświeżeniami usuń harmonogram w Google Sheets oraz odpowiadające mu połączenia Unity Catalog w Azure Databricks, a następnie odtwórz harmonogram. Aby uzyskać więcej informacji na temat połączeń Unity Catalog, zobacz Zarządzanie połączeniami dla funkcji Lakehouse Federation.

Zaplanowane odświeżanie nie powiodło się, ponieważ token Google wygasł lub został cofnięty

Zaplanowane odświeżenie może zakończyć się niepowodzeniem z błędem podobnym do następującego:

BAD_REQUEST: The OAuth token exchange failed with HTTP status code 400 Bad Request. ... Map(error -> invalid_grant, error_description -> Token has been expired or revoked.)

W pasku bocznym łącznika historia wykonania pokazuje: Ostatnie uruchomienie nie powiodło się, ponieważ brakuje poświadczeń Google Sheets lub wygasły. Ponownie autoryzuj połączenie z poziomu opcji Skonfiguruj połączenie.

Ten błąd oznacza, że autoryzacja Google przechowywana dla właściciela harmonogramu nie jest już ważna. Typowe przyczyny:

  • Użytkownik usunął konektorowi dostęp do swojego konta Google.
  • Token został cofnięty lub ograniczony przez politykę administratora Google Workspace.
  • Autoryzacja nie była wykorzystywana przez sześć miesięcy. Zobacz wygaśnięcie tokena odświeżenia w dokumentacji Google.

Aby naprawić błąd, właściciel harmonogramu ponownie autoryzuje aplikację Google Sheets:

  1. Na pasku bocznym łącznika Azure Databricks w arkuszach Google kliknij kartę Zapisane importy.
  2. Na górze karty kliknij ikonę planowania akcji po prawej stronie ikony odświeżania. Następnie kliknij Ustaw połączenie.
  3. Kliknij Autoryzuj Google Sheets i dokończ logowanie do Google.

Okno pokazuje, że autoryzacja Google Sheets jest aktywna. Twoje obecne harmonogramy wracają do następnego zaplanowanego uruchomienia. Nie musisz ich tworzyć ponownie.

Jeśli opcja Autoryzuj Google Sheets nie pojawi się, poproś administratora metastore o cofnięcie twoich poświadczeń użytkownika na stronie połączenia databricks_google_connection w Eksploratorze katalogu. Następnie powtórz te kroki.

Ograniczenia

  • Nie można edytować zaplanowanego odświeżania. Możesz wyświetlać lub usuwać tylko istniejące harmonogramy. Aby zmodyfikować harmonogram, usuń go i utwórz nowy.
  • Jeśli edytujesz zapytanie używane przez harmonogram, harmonogram nie będzie automatycznie pobierać zmian. Aby zastosować zaktualizowany tekst zapytania, usuń harmonogram i utwórz go ponownie.
  • Nie można zaplanować odświeżania w tabelach przestawnych. Interfejs API Google aktualizuje tylko nieprzetworzone dane zapytania i nie może modyfikować konfiguracji przestawnej, jeśli schemat wyników zapytania ulegnie zmianie.
  • Pojedynczy harmonogram może obejmować maksymalnie 20 importów.
  • Tekst zapytania dla importów używanych w zaplanowanym odświeżaniu ma limit 4096 znaków.
  • Ostatnia aktualizacja o