Tworzenie warstw przy użyciu danych usługi Kusto

W tym artykule opisano dodawanie danych KQL z tabel, funkcji i zmaterializowanych widoków do usługi Fabric Maps oraz konfigurowanie warstwy wynikowej na potrzeby wizualizacji. Aby uzyskać więcej informacji na temat integracji z usługą Kusto, zobacz Integracja usługi Kusto w usłudze Fabric Maps.

Ważna

Osadzone zestawy zapytań KQL są przestarzałe do użycia w usłudze Fabric Maps. Nie można już tworzyć nowych warstw mapy przy użyciu zestawów zapytań KQL ani używać Application Lifecycle Management (ALM) do importowania czy eksportowania zestawów zapytań skojarzonych z warstwą mapy, gdyż obie te funkcje nie są już wspierane.

Istniejące warstwy mapy utworzone na podstawie zestawów zapytań KQL będą nadal działać do 29 czerwca 2026 r.

Aby zapewnić ciągłą obsługę, przeprowadź migrację istniejących warstw do funkcji Kusto, które również współpracują z ALM. Aby uzyskać więcej informacji, zobacz Migrowanie zestawu zapytań KQL do funkcji Kusto.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że:

  • Masz dostęp do bazy danych KQL w usłudze Microsoft Fabric.
  • Tabela docelowa, funkcja lub zmaterializowany widok zwraca kolumny geometryczne.
  • Masz uprawnienia do tworzenia i edytowania map w Fabric.

Limitations

Podczas tworzenia warstw na podstawie danych usługi Kusto w usłudze Fabric Maps obowiązują następujące ograniczenia:

  • Zestaw danych wyników kusto: obsługuje do 100 000 funkcji zwracanych przez zapytanie.

Tworzenie warstwy danych na podstawie bazy danych KQL

  1. Otwórz mapę w trybie edycji.

  2. W Eksploratorze wybierz kartę Elementy Fabryki

  3. Wybierz przycisk Dodaj , a następnie z listy rozwijanej wybierz pozycję Baza danych KQL .

    Zrzut ekranu przedstawiający okienko Eksploratora w Fabric Maps z kartą Elementy Fabric. Menu rozwijane Dodaj jest otwarte i wyświetla trzy opcje: Lakehouse, baza danych KQL i Ontology (wersja zapoznawcza). Na liście wyróżniono pozycję Ontology (wersja zapoznawcza). Interfejs zapewnia dostęp do źródeł danych do dodawania do warstw mapy.

  4. Rozwiń połączoną bazę danych KQL, a następnie rozwiń Tabele, Funkcje lub widoki materializowane.

    Zrzut ekranu przedstawiający okienko Eksploratora w usłudze Fabric Maps z kartą Elementy Fabric z rozwiniętą bazą danych OneLake. Hierarchia bazy danych zawiera trzy zwijane sekcje: Tabele, Zmaterializowane widoki i Funkcje.

  5. Kliknij prawym przyciskiem myszy jednostkę docelową i wybierz polecenie Pokaż na mapie.

    Zrzut ekranu przedstawiający okienko Eksploratora w usłudze Mapy sieci szkieletowej z aktywną kartą Elementy sieci szkieletowej. Menu kontekstowe jest otwarte w jednostce bazy danych KQL, wyświetlając opcję Pokaż na mapie. Menu zostanie wyświetlone na lewym pasku bocznym nad wizualizacją mapy, co umożliwia użytkownikom dodawanie wybranego źródła danych Kusto jako warstwy.

    Ta akcja powoduje uruchomienie kreatora konfiguracji warstwy danych.

  6. W kroku Podgląd danych przejrzyj dane wyjściowe zapytania, aby potwierdzić, że zwracane są oczekiwane kolumny i wartości. Ta wersja zapoznawcza odzwierciedla dane renderowane na mapie. Po potwierdzeniu wybierz pozycję Dalej.

    Zrzut ekranu przedstawiający krok podglądu wyników zapytania mapy sieci szkieletowej przedstawiający tabelę z danymi przestrzennymi. W tabeli są wyświetlane kolumny szerokości geograficznej, długości geograficznej i geometrii zawierające dziewięć wierszy danych. Lewy pasek boczny zawiera trzy kroki: Podgląd danych (obecnie aktywne i wyróżnione w teal), Ustawianie geometrii i interwału odświeżania danych oraz Przeglądanie i dodawanie do mapy. W prawym dolnym rogu znajdują się przyciski Anuluj i Dalej. Ten krok umożliwia użytkownikom sprawdzenie, czy oczekiwane kolumny i wartości współrzędnych geograficznych są obecne przed skonfigurowaniem warstwy.

  7. W kroku konfiguracji zestawu map Fabric i interwału odświeżania danych zdefiniuj sposób określenia geometrii, a następnie wybierz Dalej.

    Istnieją dwie opcje definiowania geometrii:

    1. Dane szerokości geograficznej i długości geograficznej są przechowywane w oddzielnych kolumnach

      • Wybierz Dane szerokości i długości geograficznej znajdujące się w oddzielnych kolumnach.
      • Wybierz kolumny szerokości i długości geograficznej z listy.
      • Wybierz żądany interwał odświeżania danych.

      Zrzut ekranu przedstawiający krok konfiguracji geometrii i interwału odświeżania danych w Fabric Maps. Na panelu głównym wyświetlany jest formularz z trzema sekcjami: Warstwa danych z polem nazwy zawierającym najnowsze dane lotu - USA, kolumna danych geometrii z listą rozwijaną ustawioną na dane szerokości i długości geograficznej znajdujące się w oddzielnych kolumnach, a także pola kolumny szerokości geograficznej i długości geograficznej są wypełnione. Sekcja Odświeżanie danych ma listę rozwijaną ustawioną na 5 sekund. Lewy pasek boczny przedstawia wskaźnik postępu trzyetapowego z bieżącym krokiem

    2. Dane geometryczne są przechowywane w jednej kolumnie

      • Wybierz pozycję Geometry data locates (Dane geometryczne) w jednej kolumnie.
      • Wybierz kolumnę geometryczną z listy.
      • Wybierz żądany interwał odświeżania danych.

      Zrzut ekranu przedstawiający krok konfiguracji ustawienia geometrii i interwału odświeżania danych w usłudze Fabric Maps dla kolumny z pojedynczą geometrią. W formularzu przedstawiono pole Nazwa warstwy danych z listą rozwijaną Najnowsze dane lotu — STANY ZJEDNOCZONE, Tabela rozwijana kolumny danych Geometry jest ustawiona na lokalizację danych Geometry w jednej kolumnie z wypełnionym polem kolumny geometrycznej, a lista rozwijana Odświeżanie danych ustawiona na 5 sekund. Lewy pasek boczny wyświetla wskaźnik postępu trzyetapowego z wyróżnionym ustawieniem geometrii i interwału odświeżania danych. Przyciski Wstecz i Dalej są wyświetlane w prawym dolnym rogu.

      Wskazówka

      Kiedy używać geometrii dynamicznej

      Użyj kolumny geometrii dynamicznej, gdy funkcja Kusto zwraca geometrie niepunktowe , takie jak linie lub wielokąty, lub gdy geometria jest reprezentowana jako GeoJSON. Geometria dynamiczna jest odpowiednia dla tras, granic i obszarów, w których kolumny szerokości i długości geograficznej nie są wystarczające. Aby uzyskać więcej informacji, zobacz Dynamiczny typ danych.

  8. W kroku Przeglądanie i dodawanie do mapy potwierdź ustawienia zgodnie z oczekiwaniami. Po potwierdzeniu wybierz pozycję Dodaj do mapy.

    Z danymi geometrycznymi w dwóch kolumnach:

    Mapy sieci szkieletowej — przeglądanie i dodawanie do kroku konfiguracji mapy. Formularz wyświetla źródło danych: Baza danych KQL RandomRealTimeData, Funkcja: RealTimeDataFunction1, Nazwa warstwy danych: Najnowsze dane lotu — USA, Kolumna danych Geometry: Dane szerokości i długości geograficznej znajdujące się w oddzielnych kolumnach z wypełnionymi polami szerokości i długości geograficznej, Odświeżanie danych: 5 sekund. Lewy pasek boczny zawiera trzyetapowy postęp: Podgląd danych, Ustaw geometrię i interwał odświeżania danych oraz Przejrzyj i dodaj do mapy (obecnie wyróżnione w teal). W prawym dolnym rogu znajdują się przyciski Wstecz i Dodaj do mapowania na potrzeby finalizowania konfiguracji warstwy Kusto.

    Za pomocą danych geometrycznych w jednej kolumnie:

    Mapy sieci szkieletowej — przeglądanie i dodawanie do kroku konfiguracji mapy. Formularz wyświetla następujące informacje: Źródło danych: KQL database RandomRealTimeData, Funkcja: RealTimeDataFunction1, Nazwa warstwy danych: Najnowsze dane lotu — USA, Kolumna danych geometrii: Dane geometryczne znajdują się w jednej kolumnie z wypełnionym polem geometrycznym, Odświeżanie danych: 5 sekund. Lewy pasek boczny zawiera trzyetapowy postęp: Podgląd danych, Ustaw geometrię i interwał odświeżania danych oraz Przejrzyj i dodaj do mapy (obecnie wyróżnione w zielononiebieskim). W prawym dolnym rogu znajdują się przyciski Wstecz i Dodaj do mapy w celu finalizacji konfiguracji warstwy Kusto.

    Note

    Warstwy oparte na usłudze Kusto obsługują do 100 000 funkcji zwracanych przez zapytanie. Jeśli zestaw danych przekroczy ten limit, uściślij zapytanie, aby zmniejszyć rozmiar wyniku.

  9. Po utworzeniu warstwy można skoncentrować mapę, aby powiększyć miejsce, w którym znajdują się elementy danych. W tym celu. wybierz menu kontekstowe warstwy danych (...), a następnie Powiększ, aby dopasować.

    Zrzut ekranu przedstawiający interfejs Mapy Fabric z menu kontekstowym warstwy danych i wyróżnioną opcją Dopasuj do rozmiaru.

Konfigurowanie stylów i filtrowania

Po dodaniu warstwy można wykonywać następujące czynności:

  1. Zmień typ warstwy na Znacznik dla warstw opartych na punktach.
  2. Zastosuj kolor, rozmiar i rotację przy użyciu stylu opartego na danych.
  3. Włącz klastrowanie dla gęstych zestawów danych.
  4. Dodaj filtry, aby ograniczyć wyświetlane funkcje na podstawie wartości pól.

Te opcje umożliwiają dostosowanie wizualizacji do scenariusza bez modyfikowania podstawowej jednostki KQL.

Poniższy zrzut ekranu przedstawia wielokątową warstwę danych, która jest automatycznie odświeżana co 5 sekund.

Animowana demonstracja map Fabric pokazująca aktualizację warstwy wielokątnej w czasie rzeczywistym wraz z nadejściem nowych danych lotniczych. Mapa wyświetla kolorowe wielokąty w całych Stanach Zjednoczonych, które reprezentują punkty danych, z panelem konfiguracji warstw widocznym po lewej stronie. Wielokąty zmieniają kolor i położenie, gdy dane są odświeżane co 5 sekund, co ilustruje sposób, w jaki dane na żywo z Kusto wpływają na wizualizację mapy.

Poniższy zrzut ekranu przedstawia warstwę danych punktowych, która odświeża się automatycznie co 5 sekund.

Animowana demonstracja map Fabric pokazująca warstwę wielokątną aktualizowaną w czasie rzeczywistym na mapie Stanów Zjednoczonych. Mapa przedstawia kolorowe punkty reprezentujące punkty danych lotów rozmieszczone w całych Stanach Zjednoczonych. Gdy pojawią się nowe dane, punkty zmieniają kolor i położenie, odświeżając się co 5 sekund. Panel konfiguracji warstwy jest widoczny na lewym pasku bocznym. Ta animacja ilustruje sposób, w jaki dane Kusto płynnie napływają i aktualizują wizualizacje mapy.

Następne kroki

Aby dowiedzieć się więcej o niestandardowych stylach:

Aby dowiedzieć się więcej na temat filtrowania danych: