Udostępnij za pośrednictwem


Poradnik: Tworzenie i aktywowanie reguły Aktywatora Fabric

Fabric Activator w usłudze Microsoft Fabric umożliwia podejmowanie działań w przypadku wykrycia wzorców lub warunków w strumieniach danych. Jeśli dopiero zaczynasz pracować z Fabric Activator, zobacz Co to jest Fabric Activator. W tym samouczku użyjesz przykładowych danych dołączonych do Fabric Activator, aby wykonać następujące zadania:

  • Przeglądanie przykładowego aktywatora
  • Eksplorowanie danych
  • Eksplorowanie reguły
  • Uruchamianie reguły
  • Utworzenie obiektu
  • Tworzenie reguły

Wymagania wstępne

Przed rozpoczęciem potrzebny jest obszar roboczy z pojemnością sieć szkieletowa. Więcej informacji na temat obszarów roboczych usługi Fabric można uzyskać w artykule Obszary robocze . Jeśli nie masz usługi Fabric, zostanie wyświetlony monit o uruchomienie wersji próbnej.

Tworzenie przykładowego aktywatora

  1. Przejdź do portalu sieci szkieletowej.

  2. W okienku nawigacji po lewej stronie wybierz pozycję Utwórz, a następnie wybierz pozycję Aktywacja w sekcji Real-Time Intelligence . Jeśli nie widzisz pozycji Utwórz, wybierz wielokropek(...), a następnie wybierz pozycję Utwórz.

    Zrzut ekranu przedstawiający okienko nawigacji po lewej stronie z wybraną pozycją Utwórz.

  3. Na stronie Aktywacja wybierz pozycję Wypróbuj przykład.

    Zrzut ekranu przedstawiający opcję dodawania danych lub używania przykładowych danych.

Eksplorowanie danych

W tym kroku eksplorujemy dane strumienia zdarzeń, na których jest oparty ten przykład.

Nowy aktywator zawiera sekcję Eksplorator . Przewiń w dół i wybierz strumień zdarzeń dostarczania pakietów.

Zrzut ekranu Activatora z wybranym strumieniem zdarzeń Dostarczania Pakietu.

Te zdarzenia pokazują stan pakietów w czasie rzeczywistym, które są w trakcie dostarczania.

Przyjrzyj się zdarzeniu przychodzącym i umieść kursor na danych zdarzenia w tabeli na żywo. Każdy punkt danych zawiera informacje o zdarzeniu. Może być konieczne przewinięcie, aby zobaczyć to wszystko.

Eksplorowanie reguły

Użyj reguły, aby określić wartości zdarzeń, które chcesz monitorować, warunki, które chcesz wykryć, oraz akcje, które ma podjąć Fabryczny Aktywator.

W okienku Eksplorator są wyświetlane obiekty, takie jak strumienie zdarzeń, dla tego aktywatora. Zdarzenia dostawy są jednym z obiektów utworzonych z strumienia zdarzeń dostarczania paczek.

  1. W okienku Eksplorator wybierz obiekt o nazwie Zdarzenia dostarczania. Reguły dotyczące obiektów korzystających z danych można tworzyć ze strumienia zdarzeń dostarczania pakietów. Na przykład reguła, która sprawdza pakiety pod kątem temperatury.

    Zrzut ekranu przedstawiający tabelę zdarzeń dostarczania i kolumnę temperatury.

  2. Zwróć uwagę, że sekcja Zdarzenia według identyfikatora obiektu jest zorganizowana według identyfikatora pakietu. Identyfikator pakietu to identyfikator kolumny, który jednoznacznie identyfikuje każdy pakiet. Ten unikatowy identyfikator służy do przypisywania zdarzeń pakietu do obiektów pakietu.

    Zrzut ekranu przedstawiający unikatową kolumnę ID na ekranie Zdarzenia według identyfikatora obiektu.

  3. Wybierz regułę Temperatura o nazwie Zbyt gorąco dla medycyny.

    Zrzut ekranu przedstawiający przykładową regułę.

  4. W okienku po prawej stronie zobacz okienko Definicja , aby zobaczyć, jak działa reguła. W sekcji Monitorowanie wybierz pozycję Temperatura. Wartości temperatury pochodzą z kolumny Temperature w tabeli Zdarzeń dostarczania. Kolumnę Temperature (Temperatura ) można zobaczyć na wcześniejszym zrzucie ekranu.

    Zrzut ekranu przedstawiający sekcję Monitor okienka Definicja.

  5. W sekcji Podsumowanie zobaczysz użycie rozmiaru okna, rozmiaru kroku i operacji agregacji (średniej). W zasadzie szuka średniej odczytów temperatury w ciągu 10-minutowego okna.

  6. W sekcji Warunek zostanie wyświetlony warunek reguły do monitorowania temperatur, które są wyższe niż 20 stopni Celsjusza.

  7. Przewiń dalej w dół do filtru właściwości . Nasza zasada ma zastosowanie tylko do pakietów zawierających lek. W tabeli zdarzeń dostarczania reguła analizuje kolumnę o nazwie Zawartość specjalnej opieki. W kolumnie zawartość specjalnej opieki niektóre pakiety mają wartość Medycyna.

    Zrzut ekranu przedstawiający sekcję Filtr właściwości okienka Definicja.

  8. Na koniec przewiń w dół do pozycji Akcja. Nasza reguła wysyła komunikat usługi Teams, jeśli warunek jest spełniony.

    Zrzut ekranu przedstawiający sekcję Akcja okienka Definicja.

Utworzyliśmy regułę aktywatora sieci szkieletowej. Reguła jest uruchamiana względem strumienia zdarzeń dostarczania pakietów. Reguła szuka pakietów, które mają lek i sprawdza, czy temperatura jest teraz większa niż 20 stopni Celsjusza. Gdy temperatura będzie większa niż 20 stopni Celsjusza, zostanie wysłany komunikat usługi Teams.

Zapoznaj się z innymi regułami, aby dowiedzieć się, jak działają.

Uruchamianie reguły

Teraz znasz zdarzenia i obiekty używane do tworzenia reguły. Następnym krokiem jest uruchomienie reguły.

  1. Wybierz pozycję Zbyt gorąco dla medycyny.

  2. Opcjonalnie wyślij komunikat testowy, wybierając pozycję Wyślij mi akcję testową. Najpierw sprawdź, czy jesteś adresatem.

    Zrzut ekranu przedstawiający sekcję Akcja okienka Definicja z wyróżnionym przyciskiem Wyślij mi akcję testową.

  3. Powinien zostać wyświetlony komunikat podobny do następującego:

    Zrzut ekranu przedstawiający przykładowe powiadomienie usługi Teams.

  4. Wybierz Start. Powoduje to, że reguła stanie się aktywna. Otrzymasz wiadomość usługi Teams za każdym razem, gdy pakiet leków jest zbyt gorący. Reguła powinna być wyzwalana kilka razy co godzinę.

    Zrzut ekranu przedstawiający wyróżniony przycisk Start.

  5. Później możesz wyłączyć regułę przy użyciu przycisku Zatrzymaj na wstążce.

    Zrzut ekranu przedstawiający wyróżniony przycisk Zatrzymaj na wstążce.

Utworzenie obiektu

Teraz nadszedł czas, aby utworzyć własny obiekt. W tej sekcji usuń obiekt Package . Następnie utwórz go ponownie, aby śledzić stan pakietów przesyłanych, w których godziny dostawy stają się większe niż 25.

  1. W okienku Eksplorator kliknij prawym przyciskiem myszy pozycję Pakiet, a następnie wybierz polecenie Usuń. W oknie Usuwanie elementu wybierz pozycję Usuń.

    Zrzut ekranu przedstawiający menu Usuń w obiekcie Pakiet.

  2. Wybierz strumień Zdarzenia dostarczania pakietów, a następnie na wstążce wybierz pozycję Nowy obiekt.

    Zrzut ekranu przedstawiający przycisk Nowy obiekt na wstążce.

  3. W okienku Obiekt kompilacji po prawej stronie wykonaj następujące kroki:

    1. Nadaj nowemu obiektowi nazwę Package2.

    2. Wybierz pozycję PackageId jako unikatowy identyfikator.

    3. Wybierz HoursInTransit i City jako właściwości obiektu.

    4. Wybierz pozycję Utwórz.

      Zrzut ekranu przedstawiający panel obiektu Build.

Tworzenie nowej reguły

Utwórz regułę, która ostrzega Użytkownika, jeśli czas tranzytowy w dostawie przekracza próg.

  1. Wybierz nową właściwość HoursInTransit . Na wstążce wybierz pozycję Nowa reguła.

    Zrzut ekranu przedstawiający przycisk Nowa reguła na wstążce.

  2. W okienku Tworzenie reguły wykonaj następujące kroki:

    1. W polu Warunek wybierz pozycję Wzrost powyżej.

    2. W polu Wartość wybierz wartość 25.

    3. W polu Wystąpienie wybierz pozycję Za każdym razem, gdy warunek zostanie spełniony.

    4. W polu Akcja wybierz jedną z opcji, aby wysłać wiadomość e-mail za pomocą Teams.

    5. Wybierz pozycję Utwórz.

      Zrzut ekranu przedstawiający okienko Tworzenie reguły.

  3. Reguła powinna być widoczna w obszarze HoursInTransit w okienku Eksplorator. Wybierz regułę. W środkowym okienku wybierz ikonę ołówka u góry i zaktualizuj nazwę na Średni czas tranzytowy powyżej miejsca docelowego.

    Zrzut ekranu przedstawiający ikonę ołówka, aby zmienić nazwę reguły.

  4. W okienku Definicja po prawej stronie wybierz pozycję HoursInTransit. Następnie wybierz opcję Dodaj podsumowanie>Średnia.

    Zrzut ekranu przedstawiający okienko Definicja z wybraną agregacją Średnia.

  5. Ustaw rozmiar okna agregacji na pięć minut i rozmiar kroku pięć minut, a następnie wybierz pozycję Zapisz.

    Zrzut ekranu przedstawiający okienko Definicja z oknem i rozmiarem kroku.

  6. Wykres monitora jest aktualizowany, aby odzwierciedlić podsumowanie, a wykres monitora Twojej reguły wygląda następująco.

    Zrzut ekranu przedstawiający wykres średniego czasu przejazdu dla samouczka aktywatora.

  7. Przetestuj regułę, wybierając przycisk Wyślij mi akcję testową. Upewnij się, że otrzymasz alert. W przypadku korzystania z poczty e-mail może upłynąć minuta lub dwie.

    Zrzut ekranu przedstawiający przycisk Testuj wybrany na wstążce.

  8. Rozpocznij regułę, wybierając pozycję Zapisz i rozpocznij w okienku Definicja lub wybierając pozycję Rozpocznij na wstążce.

    Zrzut ekranu przedstawiający przycisk Start na wybranej wstążce.

    Utworzono pierwszy obiekt i regułę. W następnych krokach możesz spróbować skonfigurować inne reguły w obiekcie Package2 .

    Kiedy jesteś gotowy do wypróbowania użycia Fabric Activator na własnych danych, wykonaj kroki opisane w artykule Pobieranie danych dla Fabric Activator.

Czyszczenie zasobów

Po zakończeniu pracy z regułami utworzonymi w ramach samouczka pamiętaj, aby je zatrzymać. Jeśli nie wstrzymasz działania reguł, nadal będziesz otrzymywać powiadomienia o regułach. Mogą również zostać naliczone opłaty za przetwarzanie w tle. Wybierz każdą regułę z kolei i wybierz przycisk Zatrzymaj na wstążce.

Możesz również dowiedzieć się więcej o usłudze Microsoft Fabric: