Erweiterte Bearbeitung für Datenzielabfragen in Dataflow Gen2 (Vorschau)

Wenn Sie ein Datenziel in Dataflow Gen2 konfigurieren, erstellt das System automatisch interne Abfragen, die die Navigations- und Ladelogik für Ihr Ziel verarbeiten. In den meisten Fällen müssen Sie nicht direkt mit diesen Abfragen interagieren. Für erweiterte Szenarien, in denen Sie jedoch mehr Kontrolle über das Zielverhalten benötigen, können Sie die erweiterte Bearbeitung aktivieren, um die Zielabfragen direkt mithilfe von Power Query M-Code zu ändern.

Voraussetzungen

Bevor Sie die erweiterte Bearbeitung für Datenzielabfragen verwenden, sollten Sie mit:

• Was ist Dataflow Gen2?
• Dataflow Gen2-Datenziele und verwaltete Einstellungen
• Power Query M – Formelsprache

Erweiterte Bearbeitung für Datenzielabfragen aktivieren

Standardmäßig ist das Feature "Erweiterte Bearbeitung" für Datenzielabfragen deaktiviert. Sie müssen sie explizit in den Datenflussoptionen aktivieren, bevor Sie auf den erweiterten Editor zugreifen können.

1. Öffnen Sie den Datenfluss im Power Query-Editor.

2. Wählen Sie " Optionen " auf der Registerkarte " Start " im Menüband aus.

3. Scrollen Sie im Dialogfeld "Optionen " nach unten zum Abschnitt "Datenziele ".

4. Aktivieren Sie das Kontrollkästchen zum Aktivieren der erweiterten Bearbeitung für Datenzielabfragen.

   

5. Es wird ein Warndialogfeld angezeigt, in dem erläutert wird, dass das Ändern von Zielabfragen zu unerwartetem Verhalten führen oder den Datenfluss unterbrechen kann. Lesen Sie die Warnung sorgfältig.

   

6. Wählen Sie "OK" aus, um das Feature zu bestätigen und zu aktivieren.

7. Wählen Sie 'OK' aus, um das Dialogfeld "Optionen" zu schließen.

Verwenden des erweiterten Editors für Zielabfragen

Nachdem Sie die erweiterte Bearbeitung aktiviert haben, können Sie auf den erweiterten Editor für alle Datenzielabfragen in Ihrem Datenfluss zugreifen.

1. Suchen Sie im Bereich "Abfragen " den Abschnitt "Datenziel", in dem Ihre konfigurierten Ziele angezeigt werden.

2. Klicken Sie mit der rechten Maustaste auf das Ziel, das Sie bearbeiten möchten.

3. Wählen Sie im Kontextmenü den erweiterten Editor aus.

   

4. Das Fenster "Erweiterter Editor " wird geöffnet, in dem der M-Code für die Zielabfrage angezeigt wird.

   

   Hinweis

   Der erweiterte Editor zeigt ein Warnbanner an, das Sie daran erinnert, dass das Ändern der Abfrage zu unerwartetem Verhalten führen kann oder den Datenfluss zu unterbrechen.

5. Nehmen Sie Ihre Änderungen am M-Code nach Bedarf vor.

6. Wählen Sie "OK" aus, um Ihre Änderungen zu speichern, oder "Abbrechen ", um sie zu verwerfen.

Grundlegendes zur Zielabfragestruktur

Wenn Sie den erweiterten Editor für eine Zielabfrage öffnen, wird M-Code angezeigt, der einem bestimmten Muster folgt. Hier ist ein Beispiel für eine typische Zielabfrage für Lakehouse:

let
    Pattern = Lakehouse.Contents([HierarchicalNavigation = null, CreateNavigationProperties = false, EnableFolding = false]),
    Navigation_1 = Pattern{[workspaceId = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"]}[Data],
    Navigation_2 = Navigation_1{[lakehouseId = "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"]}[Data],
    TableNavigation = Navigation_2{[Id = "Table", ItemKind = "Table"]}?[Data]?
in
    TableNavigation

Diese Abfrage enthält:

• Muster: Die Verbindung mit dem Zieltyp (z. B Lakehouse.Contents. )
• Navigationsschritte: Schritte, die zum spezifischen Arbeitsbereich, Element und zur Tabelle navigieren
• Endgültige Ausgabe: Der Verweis auf die Zieltabelle oder Datei

Häufige Szenarien für die erweiterte Bearbeitung

Obwohl die meisten Benutzer Zielabfragen nicht direkt ändern müssen, sind hier einige Szenarien aufgeführt, in denen die erweiterte Bearbeitung hilfreich sein kann:

Ändern von Ziel-IDs

Wenn Sie die Arbeitsbereichs-ID, die Lakehouse-ID oder andere Ziel-IDs aktualisieren müssen, ohne das gesamte Ziel neu zu konfigurieren, können Sie sie direkt im M-Code ändern.

Behandeln von Zielproblemen

Beim Auftreten von Überprüfungsfehlern kann das Anzeigen des unformatierten M-Codes Ihnen helfen, die genaue Konfiguration zu verstehen und potenzielle Probleme zu identifizieren. Weitere Informationen zu Überprüfungsfehlern finden Sie unter Gültigkeitsprüfungsregeln für Datenziele.

Erweiterte Parametrisierung

Während die Standardbenutzeroberfläche die grundlegende Parametrisierung für Tabellennamen unterstützt, können Sie mit der erweiterten Bearbeitung andere Aspekte der Zielabfrage parametrisieren, die in der Benutzeroberfläche nicht verfügbar gemacht werden.

Wichtige Überlegungen

Beachten Sie diese Überlegungen bei der Verwendung der erweiterten Bearbeitung:

• Benutzeroberflächenunterstützung deaktiviert: Nachdem Sie eine Zielabfrage mit erweiterter Bearbeitung geändert haben, funktioniert die Standardbenutzeroberfläche zum Ändern dieses Ziels nicht mehr. Sie müssen den erweiterten Editor weiterhin für weitere Änderungen an diesem Ziel verwenden.

• Überprüfung: Änderungen, die Sie im erweiterten Editor vornehmen, unterliegen Gültigkeitsprüfungsregeln. Ungültige Änderungen verursachen Überprüfungsfehler während der Veröffentlichung oder Aktualisierung.

• Rückgabetyp: Die Zielabfrage muss einen gültigen Typ (Tabelle, Binärdatei oder Null) zurückgeben. Wenn andere Typen wie Funktionen oder Listen zurückgegeben werden, tritt ein DestinationQueryHasUnsupportedScript Fehler auf.

• Datenquellenverweise: Die Zielabfrage sollte genau auf eine Datenquelle verweisen. Das Verweisen auf mehrere Datenquellen oder keine Datenquellen verursacht Überprüfungsfehler.

• Nicht unterstützte Änderungen: Einige Änderungen werden nicht unterstützt und können dazu führen, dass der Datenfluss fehlschlägt. Testen Sie Ihre Änderungen immer gründlich, bevor Sie sie in der Produktion bereitstellen.

• Keine Rückgängig: Im erweiterten Editor gespeicherte Änderungen können nicht automatisch wiederhergestellt werden. Erwägen Sie das Dokumentieren der ursprünglichen Abfrage, bevor Sie Änderungen vornehmen.

Erweiterte Bearbeitung deaktivieren

Wenn Sie keine erweiterten Bearbeitungsfunktionen mehr benötigen, können Sie das Feature deaktivieren:

1. Wählen Sie "Optionen " auf der Registerkarte " Start " aus.
2. Deaktivieren Sie im Abschnitt "Datenziele " das Kontrollkästchen " Erweiterte Bearbeitung für Datenzielabfragen aktivieren".
3. Wählen Sie OK aus, um die Einstellung zu speichern.

Verwandte Inhalte

• Dataflow Gen2-Datenziele und verwaltete Einstellungen
• Gültigkeitsprüfungsregeln für Datenziele
• Datenflussaktualisierung
• Anzeigen des Aktualisierungsverlaufs und Überwachen Ihrer Dataflows