Aktualisieren der SQL-Endpunktaktivität

Mit der Aktualisierungs-SQL-Endpunktaktivität in Microsoft Fabric-Pipelines können Sie einen Lakehouse SQL-Endpunkt programmgesteuert als Teil eines koordinierten Workflows aktualisieren. Mit diesem Ansatz wird sichergestellt, dass nachgeschaltete Verbraucher – z. B. Power BI-Berichte, Notizbücher oder externe SQL-Clients – die neuesten Daten nach Abschluss der Datenvorbereitung oder Wartungsschritte anzeigen.

Verwenden Sie diese Aktivität, um SQL-Endpunkte umgehend aktuelle Updates widerzuspiegeln, ohne sich auf manuelle Aktualisierungen oder Ad-hoc-Prozesse zu verlassen. Verwenden Sie diese Aktivität, wenn Ihre Pipeline:

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

Voraussetzungen

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

• Ein Mandantenkonto mit einem aktiven Abonnement. Kostenlos ein Konto erstellen.
• Ein Arbeitsbereich mit einem Lakehouse
• Für das Lakehouse ist ein SQL-Endpunkt vorhanden.
• Die Pipelineidentität (Benutzer- oder Dienstprinzipal) verfügt über die Berechtigung zum Aktualisieren des SQL-Endpunkts.

Fügen Sie eine SQL-Endpunktaktualisierungsaktivität zu Ihrer Pipeline in der Benutzeroberfläche hinzu.

1. Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.  

2. Suchen Sie im Bereich "Pipelineaktivitäten" nach "SQL-Endpunkt aktualisieren", und wählen Sie ihn aus, um ihn dem Pipeline-Canvas hinzuzufügen.  

   

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

   

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

Aktualisieren von SQL Endpoint-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. Geben Sie den SQL-Endpunkt an, der die zu aktualisierende materialisierte Seeansicht enthält. Dieser SQL-Endpunkt ist das Lakehouse, dessen SQL-Endpunkt Sie aktualisieren möchten. Der SQL-Endpunkt, der dem ausgewählten Lakehouse zugeordnet ist.

   

Aktivitätsverhalten

Wenn die Aktivität abgeschlossen ist:

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

  

• Ein NotRun-Status im Ausgabe-Popup bedeutet, dass die Aktualisierung des SQL-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.

  

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

Häufige Szenarien

• Aktualisierung des SQL-Endpunkts, nachdem ein Notebook transformierte Daten in ein Lakehouse geschrieben hat.
• Auslösen einer Aktualisierung eines SQL-Endpunkts nach Abschluss von Optimierungs- oder Vakuumvorgängen.
• Sicherstellen, dass Berichte und Dashboards den neuesten Lakehouse-Zustand an gut definierten Punkten in einer Pipeline abfragen.

Warum schlägt die SQL-Endpunktaktualisierung fehl, wenn zugrunde liegende Daten gesperrt sind?

Die Aktualisierungs-SQL-Endpunktaktivität kann zeitweise 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, da der SQL-Endpunkt interne Sperren abrufen 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 basierend darauf erwartet, wie SQL-Endpunkte Metadatenaktualisierungsvorgänge verwalten.

Symptome

• Die Aktivität schlägt zeitweise fehl, nicht konsistent.
• Fehlermeldungen weisen auf Aktualisierungskonflikte oder Sperrkonflikte hin.
• Pipelines mit mehreren sequenziellen Aktualisierungs-SQL-Endpunktaktivitäten zeigen höhere Fehlerraten an.

Grundursache

SQL-Endpunkte erfordern 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 bei der Aktualisierungs-SQL-Endpunktaktivität kein Fehler. 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 von nur einer SQL-Aktualisierungsendpunktaktivität am Ende der Verarbeitung
• Implementieren eines Terminplans für wiederkehrende Aktualisierungen

Verwenden von nur einer SQL-Aktualisierungsendpunktaktivität am Ende der Verarbeitung

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

• Alle Aufnahme-, Transformations- und Aktualisierungsaktivitäten werden zuerst ausgeführt,
• Anschließend wird am Ende nur eine Aktualisierungs-SQL-Endpunktaktivität ausgeführt.
• Bei diesem Ansatz werden fehler nicht vollständig beseitigt, aber deutlich reduziert, wie oft sie auftreten.

Implementieren eines Terminplans für wiederkehrende Aktualisierungen

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 der Sperrung fehlschlagen, aber genug erfolgreich, um Ihren SQL-Endpunkt relativ auf dem neuesten Stand zu halten.

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.

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

• Die Aktualisierungs-SQL-Endpunktaktivität kann zeitweise fehlschlagen, wenn andere Prozesse die zugrunde liegenden Lakehouse-Daten aktiv aktualisieren. Problemumgehungen finden Sie im Abschnitt Warum ist die SQL-Endpunktaktualisierung fehlgeschlagen, wenn zugrunde liegende Daten gesperrt sind?

Verwandte Inhalte

• Aktualisieren von SQL-Endpunktmetadaten mit der REST-API