Aktivität des SQL-Analyseendpunkts aktualisieren

Die Refresh SQL Analytics Endpunkt-Aktivität in Microsoft Fabric Pipelines ermöglicht es Ihnen, einen Lakehouse SQL-Analytics-Endpunkt programmatisch als Teil eines orchestrierten Workflows zu aktualisieren. Es ist Teil der Lakehouse Utility Suite für Pipelines und wird in der Regel nach der Lakehouse Maintenance-Aktivität (z. B. nach OPTIMIZE- oder VAKUUM-Vorgängen) verwendet. Nachgeschaltete Verbraucher – z. B. Power BI-Berichte, Notizbücher oder externe SQL-Clients – sehen die neuesten Daten nach Abschluss der Datenvorbereitung oder Wartungsschritte.

Nutzen Sie diese Aktivität, damit SQL-Analyseendpunkte aktuelle Änderungen sofort widerspiegeln, ohne auf manuelle Aktualisierungen oder Ad-hoc-Prozesse angewiesen zu sein. Verwenden Sie diese Aktivität, wenn Ihre Pipeline:

  • Aktualisiert oder verwaltet Lakehouse-Daten (z. B. nach Kopieraufträgen, Notizbuchausführung oder Lakehouse-Wartungsaktivitäten).
  • Benötigt, dass der SQL-Analyse-Endpunkt von Lakehouse die neuesten Metadaten und Datenänderungen widerspiegelt.
  • Erfordert eine deterministische Aktualisierungszeitdauer vor nachgelagerten Schritten wie Berichterstellung, Analyse oder Exporte.

Voraussetzungen

Stellen Sie vor der Verwendung dieser Aktivität folgendes sicher:

Füge in der Benutzeroberfläche deiner Pipeline eine Aktualisierungsaktivität für den SQL-Analyseendpunkt hinzu

  1. Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.

  2. Suche im Pipeline-Aktivitäten-Fenster nach Refresh SQL Analytics Endpoint und wähle ihn aus, um ihn der Pipeline-Canvas hinzuzufügen.

    Screenshot der Aktualisierung des SQL-Analytics-Endpunkts im Aktivitäten-Bereich.

  3. Wählen Sie die neue Refresh SQL-Analytics-Endpunktaktivität auf der Canvas aus, falls sie noch nicht ausgewählt ist.

    Screenshot der Aktivität des Endpunkts für die Aktualisierung von SQL-Analysen auf der Pipeline-Arbeitsfläche.

    Tipp

    Sie können diese Aktivität zusammen mit anderen Lakehouse Utility Suite-Aktivitäten wie der Lakehouse Maintenance-Aktivität in derselben Pipeline koordinieren, sodass Wartung und Aktualisierung in Folge ausgeführt werden.

  4. Informationen zum Konfigurieren der Registerkarte Allgemein finden Sie unter Allgemeine Einstellungen-Anleitung.

Aktualisieren Sie die SQL Analytics Endpunkt-Aktivitätseinstellungen

  1. Wählen Sie die Registerkarte "Einstellungen " aus, um die Aktivität zu konfigurieren.  

  2. Konfigurieren Sie die Verbindung, indem Sie eine vorhandene Verbindung aus der Dropdownliste " Verbindung " auswählen oder eine neue Verbindung erstellen und die Konfigurationsdetails angeben.

  3. Geben Sie den Arbeitsbereich an, der das Lakehouse enthält.

  4. Gib die ID des SQL-Analyseendpunkts für das Lakehouse an, das du aktualisieren möchtest. Die Aktualisierung aktualisiert die Metadaten des Lakehouse SQL-Analytics-Endpunkts, sodass sie die aktuellen Daten und Schemaänderungen widerspiegeln.

    Screenshot der Aktualisierung der SQL-Analytics-Endpunkt-Aktivitätseinstellungen, bei denen du den SQL-Analytics-Endpunkt angibst.

Aktivitätsverhalten

Wenn die Aktivität abgeschlossen ist:

  • Wenn das Ausgabe-Popup den Erfolgsstatus anzeigt, synchronisiert die Anforderung nicht synchronisierte Daten erfolgreich.

    Screenshot eines Erfolgsstatus im Ausgabe-Popup der Aktivität.

  • Ein NotRun-Status im Output-Pop-up bedeutet, dass die Aktualisierung des SQL-Analytics-Endpunkts nicht ausgeführt wurde. Diese Bedingung bedeutet in der Regel, dass Sie seit der letzten Synchronisierung keine neuen Daten hinzugefügt haben, sodass Sie sie nicht ausführen müssen.

    Screenshot eines NotRun-Status im Popupmenü

  • Wenn das Popup "Ausgabe" den Fehlerstatus anzeigt, ist ein Fehler aufgetreten.

Hinweis

Die Aktivitätsausführung legt diese Status im Ausgabe-Popup fest. Verwechseln Sie diese Status nicht mit dem Aktivitätsstatus selbst.

Häufige Szenarien

  • Das Aktualisieren des SQL-Analytics-Endpunkts, nachdem ein Notebook transformierte Daten in ein Lakehouse geschrieben hat.
  • Lösen Sie eine Aktualisierung des SQL-Analytics-Endpunkts aus, nachdem die Lakehouse-Wartungsaktivität (OPTIMIZE oder VACUUM) abgeschlossen ist.
  • Sicherstellen, dass Berichte und Dashboards den aktuellsten Lakehouse-Zustand an klar definierten Punkten in einer Pipeline abfragen.

Warum schlägt die Aktualisierung meines SQL-Analytics-Endpunkts fehl, wenn die zugrunde liegende Daten gesperrt sind?

Die Aktualisierungsaktivität des SQL-Analyseendpunkts kann gelegentlich fehlschlagen, wenn andere Prozesse die zugrunde liegenden Lakehouse-Daten aktiv aktualisieren. Zu diesen Prozessen gehören Aufnahmepipelinen, Notizbücher oder gleichzeitige Schreibvorgänge.

Dieser Fehler tritt auf, weil der SQL-Analytics-Endpunkt interne Sperren erwerben muss, um die Aktualisierung abzuschließen. Wenn ein anderer Vorgang die Daten sperrt, läuft die Anforderung ab oder gibt einen Fehler zurück.

Dieses Verhalten wird erwartet, basierend darauf, wie SQL-Analytics-Endpunkte Metadaten-Aktualisierungsoperationen verwalten.

Symptome

  • Die Aktivität schlägt zeitweise fehl, nicht konsistent.
  • Fehlermeldungen weisen auf Aktualisierungskonflikte oder Sperrkonflikte hin.
  • Pipelines mit mehreren aufeinanderfolgenden Aktivitäten für SQL-Analyseendpunkte weisen höhere Fehlerraten auf.

Grundursache

SQL-Analytics-Endpunkte benötigen während der Aktualisierung exklusiven Zugriff auf bestimmte Metadatenstrukturen. Wenn gleichzeitig ein anderer Berechnungsprozess in das Lakehouse schreibt, kommt es zu einem Sperrenkonflikt.

Dieses Verhalten ist kein Defekt in der Refresh-SQL-Analytics-Endpunkt-Aktivität. Dies ist das natürliche Ergebnis gleichzeitiger Lese- und Schreibvorgänge für die zugrunde liegenden Daten.

Problemumgehungen

Zwei praktische Ansätze können dieses Problem beheben:

Verwenden Sie am Ende der Verarbeitung nur eine Aktivität für den SQL-Analytics-Endpunkt „Aktualisieren“

Um die Wahrscheinlichkeit von Sperrkonflikten zu verringern, konsolidieren Sie Ihre Pipeline so, dass:

  • Alle Aufnahme-, Transformations- und Aktualisierungsaktivitäten werden zuerst ausgeführt,
  • Dann wird am Ende nur eine Aktualisierungsaktivität für den SQL-Analytics-Endpunkt ausgeführt.
  • Bei diesem Ansatz werden fehler nicht vollständig beseitigt, aber deutlich reduziert, wie oft sie auftreten.

Implementiere einen wiederkehrenden Aktualisierungsplan

Wenn Ihr Szenario zu einem bestimmten Zeitpunkt keine strenge transaktionsbezogene Konsistenz erfordert, übernehmen Sie ein wiederkehrendes Aktualisierungsmuster:

  • Planen Sie eine Aktualisierung alle 15 Minuten – kontinuierlich. Einige Aktualisierungsversuche können aufgrund von Sperren fehlschlagen, es sind jedoch genügend erfolgreich, um Ihren SQL-Analyseendpunkt weitgehend aktuell zu halten.

Screenshot einer wiederkehrenden SQL-Analytics-Endpunkt-Terminplanungskonfiguration.

Dieser Ansatz ist praktisch und robust für viele Analyseworkloads.

Speichern und Ausführen oder Planen der Pipeline

Wechseln Sie oben im Pipeline-Editor zur Registerkarte " Start ", und wählen Sie die Schaltfläche "Speichern" aus, um Ihre Pipeline zu speichern. Wählen Sie "Ausführen" aus, um sie direkt auszuführen, oder planen Sie die Ausführung zu bestimmten Zeiten oder Intervallen. Weitere Informationen zu Pipelineausführungen finden Sie unter: Pipelineausführungen planen.

Screenshot der Registerkarte

Nach dem Ausführen können Sie die Ausführung der Pipeline überwachen und den Ausführungsverlauf über die Registerkarte Ausgabe unterhalb des Zeichenbereichs anzeigen.

Bekannte Probleme

Verwandte Inhalte

  • Last updated on