Odśwież aktywność punktu końcowego analizy SQL

Aktywność odświeżania punktu końcowego SQL analytics w potokach Microsoft Fabric umożliwia programowe odświeżanie punktu końcowego SQL analytics usługi Lakehouse w ramach zorganizowanego przepływu pracy. Jest to część pakietu narzędziowego Lakehouse Utility Suite dla potoków i jest zwykle używana po aktywności konserwacyjnej Lakehouse (na przykład po operacjach OPTIMIZE lub VACUUM). Ostateczni odbiorcy, tacy jak raporty Power BI, notesy lub zewnętrzni klienci SQL, zobaczą najnowsze dane po zakończeniu przygotowywania lub konserwacji danych.

Wykorzystaj tę aktywność, aby endpointy analityki SQL natychmiast odzwierciedlały najnowsze aktualizacje, bez konieczności polegania na ręcznych odświeżaniach czy procesach ad hoc. Użyj tego działania, gdy pipeline:

  • Aktualizuje lub przechowuje dane usługi Lakehouse (na przykład po kopiowaniu zadań, wykonywania notesu lub działaniach konserwacyjnych usługi Lakehouse).
  • Wymaga, aby endpoint analityki SQL Lakehouse odzwierciedlał najnowsze metadane i zmiany danych.
  • Wymaga deterministycznego harmonogramu odświeżania przed takimi krokami jak raportowanie, analizy lub eksport.

Wymagania wstępne

Przed użyciem tego działania upewnij się, że:

Dodaj aktywność endpoint analizy SQL do swojego pipeline'u w interfejsie UI

  1. Utwórz nowy pipeline w obszarze roboczym.

  2. W panelu Activities potoku wyszukaj opcję Odśwież punkt końcowy analizy SQL i wybierz ją, aby dodać ją do kanwy potoku.

    Zrzut ekranu aktywności odświeżania punktu końcowego SQL Analytics w panelu Aktywności.

  3. Wybierz nową aktywność endpoint Refresh SQL Analytics na canvas, jeśli nie jest ona jeszcze wybrana.

    Zrzut ekranu przedstawiający aktywność odświeżania punktu końcowego analityki SQL na kanwie potoku.

    Wskazówka

    Możesz zorganizować to działanie wraz z innymi działaniami pakietu Lakehouse Utility Suite, takimi jak działanie konserwacji usługi Lakehouse, w tym samym potoku, dzięki czemu konserwacja i odświeżanie są uruchamiane w kolejności.

  4. Zapoznaj się z wskazówkami dotyczącymi ustawień ogólnych, aby skonfigurować kartę ustawień ogólnych.

Odśwież ustawienia aktywności punktu końcowego analizy SQL

  1. Wybierz kartę Ustawienia , aby skonfigurować działanie.  

  2. Skonfiguruj połączenie, wybierając istniejące połączenie z listy rozwijanej Połączenie lub tworząc nowe połączenie i określając szczegóły konfiguracji.

  3. Określ obszar roboczy zawierający usługę Lakehouse.

  4. Określ punkt końcowy analiz SQL jako Identyfikator punktu końcowego analiz SQL dla magazynu Lakehouse, który chcesz odświeżyć. Odświeżenie aktualizuje metadane endpointów analityki SQL Lakehouse, aby odzwierciedlały najnowsze zmiany w danych i schematach.

    Zrzut ekranu ustawień aktywności odświeżania punktu końcowego SQL Analytics, gdzie określasz punkt końcowy SQL Analytics.

Zachowanie działania

Po zakończeniu aktywności:

  • Jeśli w oknie podręcznym "Dane wyjściowe" pojawi się stan Powodzenie, żądanie pomyślnie synchronizuje niezsynchronizowane dane.

    Zrzut ekranu przedstawiający status Powodzenie w oknie podręcznym wyników działań.

  • Status NotRun w okienku Output oznacza, że odświeżenie endpointu analityki SQL nie zostało uruchomione. Ten warunek zwykle oznacza, że nie dodano nowych danych od ostatniej synchronizacji, więc nie trzeba ich uruchamiać.

    Zrzut ekranu stanu NotRun w wyskakującym oknie Dane wyjściowe działania.

  • Jeśli w oknie podręcznym „Dane wyjściowe” pojawi się stan Błąd, oznacza to, że wystąpił problem.

Uwaga / Notatka

Uruchomienie działania ustawia te stany w wyskakującym okienku Dane wyjściowe. Nie należy mylić tych stanów ze stanem działania.

Typowe scenariusze

  • Odświeżanie punktu końcowego analizy SQL po zapisaniu przez Notebook przekształconych danych w Lakehouse.
  • Uruchom odświeżenie endpointu analityki SQL po zakończeniu działań Lakehouse Maintenance (OPTIMIZE lub VACUUM).
  • Zapewnienie, że raporty i pulpity nawigacyjne odwołują się do najbardziej aktualnego stanu Lakehouse w jasno określonych punktach potoku danych.

Dlaczego odświeżanie mojego analitycznego punktu końcowego SQL kończy się niepowodzeniem, gdy dane źródłowe są zablokowane?

Operacja odświeżania punktu końcowego analizy SQL może sporadycznie kończyć się niepowodzeniem, gdy inne procesy aktywnie aktualizują bazowe dane w Lakehouse. Te procesy obejmują potoki pozyskiwania, notebooki lub operacje zapisu współbieżnego.

Ten błąd występuje, ponieważ punkt końcowy analizy SQL musi uzyskać wewnętrzne blokady, aby ukończyć odświeżanie. Jeśli inna operacja blokuje dane, żądanie przekracza limit czasu lub zwraca błąd.

Takie zachowanie jest oczekiwane na podstawie sposobu, w jaki endpointy analityki SQL zarządzają operacjami odświeżania metadanych.

Symptoms

  • Działanie sporadycznie kończy się niepowodzeniem, a nie regularnie.
  • Komunikaty o błędach wskazują konflikty odświeżania lub rywalizację o blokadę.
  • Potoki z wieloma następującymi po sobie działaniami odświeżania punktu końcowego analizy SQL charakteryzują się wyższym wskaźnikiem niepowodzeń.

Główna przyczyna

Endpointy analityki SQL wymagają wyłącznego dostępu do określonych struktur metadanych podczas odświeżania. Jeśli inny proces obliczeniowy zapisuje w platformie Lakehouse w tym samym czasie, wystąpi rywalizacja o blokadę.

To zachowanie nie jest błędem w aktywności odświeżania punktu końcowego SQL Analytics. Jest to naturalny wynik współbieżnych operacji odczytu i zapisu na danych bazowych.

Rozwiązania alternatywne

Dwa praktyczne podejścia mogą rozwiązać ten problem:

Używaj tylko jednej aktywności odświeżania punktu końcowego SQL Analytics na końcu przetwarzania

Aby zmniejszyć prawdopodobieństwo konfliktów blokady, skonsoliduj przepływ pracy tak aby:

  • Wszystkie działania pozyskiwania, przekształcania i aktualizacji są uruchamiane jako pierwsze,
  • Następnie na końcu jest wykonywana tylko jedna aktywność odświeżania punktu końcowego SQL Analytics.
  • Takie podejście nie eliminuje całkowicie błędów, ale znacznie zmniejsza częstotliwość ich występowania.

Wprowadź cykliczny harmonogram odświeżania

Jeśli scenariusz nie wymaga ścisłej spójności transakcyjnej w określonym momencie, zastosuj cykliczny wzorzec odświeżania:

  • Zaplanuj odświeżanie co 15 minut — w sposób ciągły. Niektóre próby odświeżenia mogą się nie powieść z powodu blokad, ale wystarczająco wiele z nich kończy się powodzeniem, aby punkt końcowy analizy SQL pozostawał względnie aktualny.

Zrzut ekranu konfiguracji harmonogramu cyklicznego odświeżania punktu końcowego SQL Analytics.

Takie podejście jest praktyczne i niezawodne w przypadku wielu obciążeń analitycznych.

Zapisz i uruchom lub zaplanuj pipeline

Przejdź do karty Narzędzia główne w górnej części edytora potoków i wybierz przycisk zapisz, aby zapisać potok. Wybierz pozycję Uruchom , aby uruchomić ją bezpośrednio, lub Zaplanuj , aby zaplanować przebiegi w określonych godzinach lub interwałach. Aby uzyskać więcej informacji na temat przebiegów potoków, zobacz: Planowanie przebiegów potoków.

Zrzut ekranu przedstawiający kartę Strona główna w edytorze potoków z wyróżnioną nazwą karty oraz przyciskami Zapisz, Uruchom i Zaplanuj.

Po uruchomieniu możesz monitorować wykonywanie potoku i wyświetlać historię uruchamiania na karcie Dane wyjściowe poniżej kanwy.

Znane problemy

Treści powiązane

  • Last updated on