Migrieren von KQL Queryset zu Kusto-Funktion

Ab März 2026 unterstützt Fabric Maps KQL-Abfragesets nicht mehr als Datenquelle zum Erstellen von Kartenebenen. Um Kusto-Daten weiterhin in Karten zu verwenden, müssen Sie neue Ebenen basierend auf KQL-Funktionen erstellen.

In diesem Artikel wird erläutert, wie Sie eine vorhandene Zuordnungsebene migrieren, die aus einer KQL-Abfrage erstellt wurde, zu einer neuen Ebene, die von einer KQL-Funktion unterstützt wird, und wie Sie die migrierte Ebene für die Visualisierung in Fabric Maps konfigurieren. Eine Übersicht über unterstützte Kusto-Datenquellen finden Sie unter Kusto-Integration in Fabric Maps. Informationen zum Erstellen neuer Ebenen aus einer Kusto-Datenquelle finden Sie unter Erstellen von Ebenen mit Kusto-Daten.

Hinweis

Vorhandene Ebenen, die aus einer KQL-Abfrage erstellt wurden, funktionieren bis zum 29. Juni 2026 weiterhin. Um Dienstunterbrechungen zu vermeiden, migrieren Sie diese Abfragen wie in diesem Artikel beschrieben zu Kusto-Funktionen.

Voraussetzungen

Bevor Sie beginnen, stellen Sie folgendes sicher:

  • Sie haben Zugriff auf eine KQL-Datenbank in Microsoft Fabric.
  • Sie verfügen über die Berechtigung zum Erstellen und Bearbeiten von Karten in Fabric.

Migrieren einer KQL-Abfrage zu einer Kusto-Funktion

Um die Migration von einem eingebetteten KQL-Abfrageset zu vereinfachen, konvertieren Sie die Abfrage in eine Kusto-Funktion, und aktualisieren Sie die Kartenebene so, dass sie auf diese Funktion verweist.

Ursprüngliche Abfrage

Das folgende Beispiel zeigt eine KQL-Abfrage, die in einer vorhandenen Kartenebene verwendet wird:

SourceTable
| where timestamp > ago(1d)

Erstellen einer Kusto-Funktion

Erstellen Sie in Ihrer KQL-Datenbank eine Funktion, die die Abfragelogik kapselt:

.create-or-alter function resultFromOneDay() {
    SourceTable
    | where timestamp > ago(1d)
}

Eine neue benutzerdefinierte gespeicherte Funktion wird unter dem Knoten "Funktionen" der KQL-Datenbank erstellt. Sie verwenden diese Funktion im nächsten Schritt, um eine neue Kartenebene zu erstellen.

Hinzufügen einer neuen Datenebene aus der Kusto-Funktion

Nachdem Sie die eingebettete KQL-Abfrage zu einer Kusto-Funktion migriert haben, erstellen Sie eine neue Zuordnungsebene, die die Funktion als Datenquelle verwendet.

  1. Erstellen Sie eine neue Datenebene aus der Kusto-Funktion, indem Sie die Schritte in " Ebenen mithilfe von Kusto-Daten erstellen" ausführen.
  2. Konfigurieren Sie die Geometrie der Ebene, die Aktualisierungseinstellungen sowie die erforderlichen Stile oder Formatierungen.
  3. Stellen Sie sicher, dass die neue Ebene auf der Karte korrekt gerendert wird.

Nachdem die neue Ebene konfiguriert und validiert worden ist, können Sie die vorhandene Kartenschicht entfernen, die aus dem eingebetteten KQL-Abfrage-Set stammt.

Die Kartenebene verweist jetzt auf eine unterstützte Kusto-Entität, sodass sie weiterhin funktioniert, da KQL-Abfragesets veraltet sind.