Tutorial: Opret og aktiver en Fabric Activator-regel

Fabric Activator i Microsoft Fabric gør det muligt for dig at foretage handlinger, når den opdager mønstre eller betingelser i datastrømme. Hvis du er ny til Fabric Activator, se Hvad er Fabric Activator. I denne vejledning bruger du de eksempeldata, der følger med Fabric Activator, til at udføre følgende opgaver:

  • Gennemgå et eksempel på et Activator-element
  • Udforsk dataene
  • Udforsk en regel
  • Start reglen
  • Opret et objekt
  • Opret en regel

Forudsætninger

Før du begynder, skal du have et arbejdsområde med kapacitet til Fabric. For at lære om Fabric arbejdsområder, se artiklen Workspaces. Hvis du ikke har Fabric, bliver du bedt om at starte en prøveperiode.

Opret en eksempel-aktivator

  1. På Fabric-forsiden, i venstre navigationspanel, vælg ellipsen (...), og vælg derefter Create.

    Skærmbillede, der viser venstre navigationsrude med Opret valgt.

  2. På siden Create , underReal-Time Intelligence, vælg Aktivator.

    Skærmbillede, der viser Create-siden med Activator valgt.

  3. På siden Activator skal du vælge Prøv eksempel.

    Skærmbillede viser venstre Indgangspunkt til Try samples.

    Følg de guidede prompts for at aktivere prøvedataene og udforsk Activator-grænsefladen.

Udforsk dataene

I dette trin udforsker du de eventstream-data, som prøven er bygget på.

Den nye Aktivator-genstand har en Explorer-sektion . Scroll ned og vælg strømmen Cykellæsninger.

Skærmbillede af Activator UI Explorer-panelet, der viser cykelaflæsninger.

Disse begivenheder viser cykelaflæsninger i realtid.

Se på de indgående begivenheder, og hold markøren over hændelsesdataene i livetabellen. Hvert datapunkt indeholder oplysninger om hændelsen. Du skal måske scrolle for at se det hele.

Udforsk en regel

Brug en regel til at specificere de hændelsesværdier, du vil overvåge, de betingelser du vil opdage, og hvilke handlinger du vil have, at Fabric Activator skal udføre.

Ruden Stifinder viser objekter, f.eks. eventstreams, for denne aktiverer. Stationslæsninger er et af de objekter, der skabes ud fra Bicycles læsningsbegivenheders eventstrømme.

  1. I Explorer-panelet skal du vælge objektet kaldet Stationslæsninger. Du kan oprette regler om objekter, der bruger data fra Bicycles reading events-eventstrømmen. For eksempel en regel, der tjekker stationer for tilgængelighed af cykler.

    Skærmbillede, der viser aflæsningerne fra cykelstationen.

  2. Bemærk, at sektionen Events efter 'BikepointID' er organiseret efter Bikepoint ID. Bikepoint ID er kolonne-ID'et, der unikt identificerer hver cykelstation. Brug dette unikke ID til at tildele cykelevents til cykelobjekter.

    Skærmbillede, der viser stationsaflæsningerne for cykelpunkt-ID.

  3. Vælg No_Empty_Docks-reglen (som står for antal tomme docks) kaldet No empty docks (Email). I det højre panel kan du se Definition-panelet for at se, hvordan reglen fungerer.

    Skærmbillede, der viser e-mailreglen Ingen tomme docks Definitionspanel.

  4. I Monitor-sektionen vælger du No_Empty_Docks. Antallet af tomme dok-værdier kommer fra kolonnen No_Empty_Docks i stationens aflæsningstabell . Du kan se kolonnen No_Empty_Docks på et tidligere screenshot.

  5. I afsnittet Betingelse ser du regelbetingelsen om at overvåge antallet af tomme dokke, der er mindre end 1.

    Skærmbillede, der viser Monitor Definitions-panelet for antal tomme docks.

  6. Scroll længere ned til Property-filtre. Reglen gælder kun for stationer på Arlington Street. I tabellen Stationslæsninger ser reglen på kolonnen kaldet Street. I Street-kolonnen har nogle af cyklerne en værdi af Arlington Street.

    Skærmbillede, der viser ejendomsfiltrene, mere specifikt Arlington Street.

  7. Scroll ned til Action. Vælg en af følgende handlinger, når betingelsen er opfyldt:

    1. Send e-mail-notifikation: Sender en e-mail til dig selv eller til andre i din organisation.

      1. For Vælg handling skal du vælge Send mail.

      2. For Til indtast modtagernes e-mailadresser , eller brug dropdown-listen til at vælge en egenskab, hvis værdi er en e-mailadresse. Din e-mailadresse er som standard udfyldt her.

      3. For emne skal du indtaste emnet i e-mailnotifikationen eller lade det være som det er.

      4. For Overskrift skal du indtaste overskriften på e-mailnotifikationen eller lade det være som det er.

        1. For Besked skal du indtaste noter til e-mailnotifikationen.

        Notat

        Når du indtaster emne, overskrift eller noter, kan du henvise til egenskaber i dataene ved at @ skrive eller vælge knappen ved siden af tekstboksene. F.eks., @No_Empty_Docks.

      5. For kontekstens skyld vælg de værdier fra dropdown-listen, som du vil inkludere i e-mailnotifikationen.

        Skærmbillede, der viser Handlingspanelet med E-mailhandlinger valgt.

    2. Send Microsoft Teams notifikation: Sender en Microsoft Teams notifikation til enkeltpersoner, en gruppechat eller en kanal. Du kan tilpasse titlen og indholdet af beskeden.

      1. For Select-handlingen vælg Teams>Besked til enkeltpersoner, Gruppechatbesked eller Kanal-opslag.

      2. Følg et af disse trin afhængigt af dit valg:

        • Hvis du valgte Besked til enkeltpersoner, indtast modtagernes e-mailadresser , eller brug dropdown-listen til at vælge en egenskab, hvis værdi er en e-mailadresse. Når betingelsen er opfyldt, sender Fabric Activator en Teams-besked til de angivne personer.
        • Hvis du valgte gruppechatbesked, vælg en gruppechat fra rullemenuen. Når betingelsen er opfyldt, poster Fabric Activator en besked i gruppechatten.
        • Hvis du valgte Kanalindlæg, vælg et hold og en kanal fra dropdown-listerne. Når betingelsen er opfyldt, sender Fabric Activator en besked til den valgte kanal.

      3. For Overskrift indtast overskriften i Teams-notifikationen.

      4. For Besked skal du indtaste noter til Teams-notifikationen.

        Notat

        Når du indtaster emne, overskrift eller noter, kan du henvise til egenskaber i dataene ved at @ skrive eller vælge knappen ved siden af tekstboksene. F.eks., @No_Empty_Docks.

      5. Til kontekst vælger du de værdier fra dropdown-listen, som du vil inkludere i Teams-notifikationen.

        Skærmbillede, der viser afsnittet Handling i ruden Definition.

    3. Kør Fabric-aktiviteter: For at konfigurere alarmen til at starte en Fabric-pipeline, Dataflow, Spark-job, notebook, Function, Copy-job eller Publish business event (preview), når betingelsen er opfyldt, følg disse trin:

      1. For Vælg handling vælg Kør Handling, Kør Pipeline, Kør Dataflow, Kør Spark-job, Kør Notebook, Kør Funktion, Kør Kopijob eller Publicer forretningsbegivenhed.
      2. Når du vælger Fabric-element, der skal køres, vælger du Fabric-elementet (Action, pipeline, dataflow, notebook, Spark-job, funktion, kopijob eller publicér forretningsbegivenhed) fra listen.
      3. Vælg Add parameter, og angiv derefter navnet på parameteren for Fabric-elementet og en værdi for det. Du kan tilføje mere end én parameter. Du kan sende parametre fra alarmdataene ved at skrive @ eller vælge knappen ved siden af tekstboksen. F.eks., @BikePointID. Kopieringsjobs accepterer ikke parametre, så dette trin gælder ikke for dem.

      Skærmbillede, der viser handlingssektionen i definitionspanelet med valgt e-mailhandling.

    4. Brugerdefinerede handlinger: For at konfigurere alarmen til at kalde en brugerdefineret handling, når betingelsen er opfyldt, følger du disse trin:

      1. For Vælg handling, vælg Opret brugerdefineret handling.

      Skærmbillede, der viser handlingssektionen i definitionspanelet med brugerdefineret handling valgt.

      1. Først, lav reglen. Derefter fuldfører du opsætningen af brugerdefinerede handlinger ved at følge trinene i Trigger brugerdefinerede handlinger (Power Automate flows).
      2. Efter du har oprettet den brugerdefinerede handling, vælger du i Definition-panelet din brugerdefinerede handling fra rullemenuen Vælg handling.

  8. Når du har konfigureret din valgte handling, vælger du Opret for at gemme din Aktivator-regel.

Du har lavet en Fabric Activator-regel. Reglen går imod cykelaflæsningernes eventstrøm. Reglen leder efter antal tomme kajer med færre end én cykel og tjekker hver gang betingelsen er opfyldt. Når antallet af cykler er mindre end 1, sender reglen en Teams-besked.

Dette eksempel på Aktivator-item indeholder andre regler. Udforsk dem i dit eget tempo for at se, hvordan de fungerer.

Start reglen

Nu hvor du er bekendt med de begivenheder og objekter, der bruges til at skabe en regel, så start reglen.

  1. Vælg No_empty_docks (Email).

  2. Du kan også sende en testmeddelelse ved at vælge Send mig en testhandling. Først, tjek at du er modtageren.

    Skærmbillede, der viser afsnittet Handling i ruden Definition med knappen Send mig en testhandling fremhævet.

  3. Du modtager en e-mail, der ligner følgende:

    Skærmbillede viser aktiveringsmail.

  4. Vælg Start. Denne handling aktiverer reglen. Du modtager en e-mail, når en kaj har færre end én cykel til rådighed. Reglen udløses hver gang betingelsen er opfyldt.

    Skærmbillede, der viser definitioner, startpanel-knap.

  5. Senere kan du slå reglen fra ved at bruge Stop-knappen på båndet.

    Skærmbillede, der viser øverste båndstopknap valgt for at stoppe reglen.

Opret et objekt

Opret nu et objekt. I dette afsnit sletter du Bike station-objektet og genskaber det med de egenskaber, du bruger i næste afsnit til at lave en regel.

  1. I Stifinder-panelet højreklikker du på Cykelstation og vælger Slet. Vælg Slet i vinduet Slet element.

    Skærmbillede viser slet-knappen for cykelstationen.

  2. Vælg Cykel-aflæsningsstrømmen , og vælg derefter Nyt objekt på båndet.

    Skærmbillede, der viser oprettelse af et nyt objekt fra Eventstream.

  3. Følg disse trin i ruden Opret objekt til højre:

    1. Navngiv dit nye objekt Cykelstation.

    2. Vælg BikepointID som det unikke ID.

    3. Vælg No_Bikes, No_Empty_Docks og Street som objektets egenskaber.

    4. Vælg Opret.

      Skærmbillede, der viser bygobjekt-panelet

Opret en regel

Opret en regel, der advarer dig, når antallet af tomme docks er mindre end 1.

  1. Vælg din nye No_Empty_Docks ejendom. Vælg Ny regel på båndet.

    Skærmbillede viser ny regel – ingen tomme docks.

  2. I definitionspanelet følger du disse trin:

    1. For Monitor vælger du attributten at overvåge og tilføjer eventuelt filtre.

    2. For Betingelse sættes betingelsen til at udløses, når No_Empty_Docks er mindre end 1.

    3. For Handling skal du vælge en af mulighederne for at sende en besked i Teams eller e-mail.

    4. Vælg Gem.

      Skærmbillede, der viser definitionspanelet.

  3. Du ser reglen under No_Empty_Docks advarsel i Explorer-panelet. Vælg reglen. I midterpanelet skal du vælge blyantikonet øverst, og opdatere navnet til No_Empty_Docks (Email).

    Skærmbillede viser ny No_Empty_Docks (e-mail) regel.

  4. I definitionspanelet til højre skal du vælge No_Empty_Docks. Vælg derefter Tilføj opsummering>Maksimal.

    Skærmbillede viser definitionspanelet med 'Tilføj opsummering' dropdown til 'Maksimum'.

  5. Sæt en aggregeringsvinduesstørrelse på ét minut og en skridtlængde til at være den samme som vinduesstørrelsen, og vælg derefter Gem.

    Skærmbillede af definitionspanelet, der viser opsummering sat til Maksimum med 1-minuts vinduesstørrelse.

  6. Diagrammet Overvåg opdateres for at afspejle opsummering, og diagrammet over regelovervågning ser sådan ud.

    Skærmbillede af Monitor-diagram, der viser opsummerede data med 1-minuts vindue og steglængde anvendt.

  7. Test reglen ved at vælge knappen Send mig en testhandling. Sørg for at få en besked. Hvis du bruger e-mail, kan det tage et minut eller to at nå frem.

    Skærmbillede af regeleditoren med knappen 'Send mig en testhandling' markeret med rødt.

  8. Start reglen ved at vælge Gem og start i ruden Definition eller ved at vælge Start på båndet.

    Skærmbillede af regelpanelet med Start-knappen fremhævet på båndet og definitionspanelet åbent.

Du har oprettet dit første objekt og din første regel. Som næste skridt kan du prøve at sætte andre regler op på Bike station-objektet .

Når du er klar til at prøve at bruge Fabric Activator på dine egne data, følger du trinene i artiklen Get data for Fabric Activator.

Fjerne ressourcer

Når du er færdig med de regler, du har lavet som en del af tutorialen, så stop dem. Hvis du ikke stopper reglerne, modtager du fortsat regelmeddelelserne. Du kan også pådrage dig gebyrer for baggrundsbehandling. Vælg hver regel ad gangen, og vælg knappen Stop på båndet.

Relateret indhold

For at lære mere om Microsoft Fabric, se:

  • Sidst opdateret den