Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Działanie Odświeżanie punktu końcowego SQL w potokach usługi Microsoft Fabric umożliwia programowe odświeżanie punktu końcowego SQL usługi Lakehouse w ramach zaplanowanego 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.
Użyj tego działania, aby punkty końcowe SQL natychmiast odzwierciedlały najnowsze aktualizacje bez konieczności polegania na ręcznych odświeżeniach lub 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 punkt końcowy SQL usługi 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:
- Konto klienta z aktywną subskrypcją. Utwórz bezpłatne konto.
- Obszar roboczy z usługą Lakehouse
- Punkt końcowy SQL istnieje dla usługi Lakehouse.
- Tożsamość potoku (użytkownik lub jednostka usługi) ma uprawnienia do odświeżania punktu końcowego SQL.
Dodaj działanie Odświeżania Punktu Końcowego SQL do potoku w interfejsie użytkownika
Utwórz nowy pipeline w obszarze roboczym.
Wyszukaj pozycję Odśwież punkt końcowy SQL w okienku Działania potoku i wybierz tę pozycję, aby dodać ją do obszaru roboczego potoku.
Wybierz nowe działanie Odśwież punkt końcowy SQL na kanwie, jeśli nie zostało jeszcze wybrane.
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.
Zapoznaj się z wskazówkami dotyczącymi ustawień ogólnych, aby skonfigurować kartę ustawień ogólnych.
Odświeżanie ustawień działania punktu końcowego SQL
Wybierz kartę Ustawienia , aby skonfigurować działanie.
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.
Określ obszar roboczy zawierający usługę Lakehouse.
Określ punkt końcowy SQL dla usługi Lakehouse, który chcesz odświeżyć. Odświeżanie aktualizuje metadane punktu końcowego SQL usługi Lakehouse, aby odzwierciedlały najnowsze dane i zmiany schematu.
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.
Stan NotRun w oknie podręcznym wyników oznacza, że odświeżenie punktu końcowego SQL nie zostało przeprowadzone. Ten warunek zwykle oznacza, że nie dodano nowych danych od ostatniej synchronizacji, więc nie trzeba ich uruchamiać.
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 SQL po zapisaniu przekształconych danych do Lakehouse przez Notebook.
- Wyzwól odświeżenie punktu końcowego SQL po zakończeniu pracy konserwacyjnej Lakehouse (OPTIMIZE lub VACUUM).
- Zapewnienie, że raporty i pulpity nawigacyjne wysyłają zapytania do najnowszego stanu usługi Lakehouse w dobrze zdefiniowanych punktach w potoku.
Dlaczego odświeżanie punktu końcowego SQL kończy się niepowodzeniem, gdy dane bazowe są zablokowane?
Działanie "Odświeżanie SQL Endpoint" może sporadycznie zakończyć się niepowodzeniem, gdy inne procesy aktywnie aktualizują bazowe dane Lakehouse. Te procesy obejmują potoki pozyskiwania, notebooki lub operacje zapisu współbieżnego.
Ten błąd występuje, ponieważ punkt końcowy SQL musi uzyskać wewnętrzne blokady w celu ukończenia odświeżania. Jeśli inna operacja blokuje dane, żądanie przekracza limit czasu lub zwraca błąd.
To zachowanie jest oczekiwane na podstawie sposobu zarządzania operacjami odświeżania metadanych przez punkty końcowe SQL.
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 sekwencyjnymi działaniami odświeżania punktu końcowego SQL pokazują wyższe współczynniki niepowodzeń.
Główna przyczyna
Punkty końcowe SQL wymagają wyłącznego dostępu do niektórych 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 wadą aktywności Odświeżania Punktu Końcowego SQL. 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żyj tylko jednego odświeżenia działania punktu końcowego SQL na końcu przetwarzania
- Implementowanie harmonogramu odświeżania cyklicznego
Użyj tylko jednego odświeżenia działania punktu końcowego SQL 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 wykonywana jest tylko jedna aktywność Odświeżania punktu końcowego SQL.
- Takie podejście nie eliminuje całkowicie błędów, ale znacznie zmniejsza częstotliwość ich występowania.
Implementowanie harmonogramu odświeżania cyklicznego
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ą zakończyć się niepowodzeniem z powodu blokady, ale wystarczająco wiele odnosi sukces, aby utrzymywać punkt końcowy SQL stosunkowo aktualnym.
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.
Po uruchomieniu możesz monitorować wykonywanie potoku i wyświetlać historię uruchamiania na karcie Dane wyjściowe poniżej kanwy.
Znane problemy
- Działanie Odświeżanie punktu końcowego SQL może sporadycznie zakończyć się niepowodzeniem, gdy inne procesy aktywnie aktualizują bazowe dane Lakehouse. Aby uzyskać obejścia, zobacz sekcję Dlaczego odświeżanie punktu końcowego SQL kończy się niepowodzeniem, gdy dane bazowe są zablokowane?