Migrowanie zestawu zapytań KQL do funkcji Kusto

Począwszy od marca 2026 r., Mapy Fabric nie obsługują już zestawów poleceń KQL jako źródła danych do generowania warstw mapy. Aby nadal korzystać z danych Kusto w mapach, należy utworzyć nowe warstwy oparte na funkcjach KQL.

W tym artykule wyjaśniono, jak przeprowadzić migrację istniejącej warstwy mapy utworzonej na podstawie zapytania KQL do nowej warstwy wspieranej przez funkcję KQL oraz jak skonfigurować zmigrowane warstwy na potrzeby wizualizacji w usłudze Mapy sieci szkieletowej. Aby uzyskać przegląd obsługiwanych źródeł danych Kusto, zobacz Integrację Kusto w Fabric Maps. Aby uzyskać informacje na temat tworzenia nowych warstw ze źródła danych Usługi Kusto, zobacz Tworzenie warstw przy użyciu danych Usługi Kusto.

Uwaga / Notatka

Istniejące warstwy utworzone na podstawie zapytania KQL będą nadal działać do 29 czerwca 2026 r. Aby uniknąć przerw w działaniu usługi, przeprowadź migrację tych zapytań do funkcji Kusto zgodnie z opisem w tym artykule.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że:

  • Masz dostęp do bazy danych KQL w usłudze Microsoft Fabric.
  • Masz uprawnienia do tworzenia i edytowania map w Fabric.

Migrowanie zapytania KQL do funkcji Kusto

Aby uprościć migrację z osadzonego zestawu zapytań KQL, przekonwertuj zapytanie na funkcję Kusto i zaktualizuj warstwę mapy w celu odwołania się do tej funkcji.

Oryginalne zapytanie

W poniższym przykładzie pokazano zapytanie KQL używane w istniejącej warstwie mapy:

SourceTable
| where timestamp > ago(1d)

Tworzenie funkcji Kusto

W bazie danych KQL utwórz funkcję, która hermetyzuje logikę zapytań:

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

Nowa funkcja przechowywana zdefiniowana przez użytkownika jest tworzona w węźle Functions bazy danych KQL. Ta funkcja zostanie użyta w następnym kroku, aby utworzyć nową warstwę mapy.

Dodawanie nowej warstwy danych z funkcji Kusto

Po przeprowadzeniu migracji osadzonego zapytania KQL do funkcji Kusto utwórz nową warstwę mapy, która używa funkcji jako źródła danych.

  1. Utwórz nową warstwę danych z funkcji Kusto, wykonując kroki opisane w temacie Tworzenie warstw przy użyciu danych Usługi Kusto.
  2. Skonfiguruj geometrię warstwy, ustawienia odświeżania i wszelkie wymagane style lub formatowanie.
  3. Sprawdź, czy nowa warstwa jest poprawnie renderowana na mapie.

Po skonfigurowaniu i zweryfikowaniu nowej warstwy można usunąć istniejącą warstwę mapy źródłową z osadzonego zestawu zapytań KQL.

Warstwa mapy odwołuje się teraz do obsługiwanej jednostki Kusto, co pozwala jej nadal działać pomimo wycofania zestawów zapytań KQL z użycia.