Opprett og administrer lagrede funksjoner

Funksjoner er gjenbrukbare spørringer eller spørringsdeler. Sanntidsintelligens støtter to typer funksjoner:

  • Innebygde funksjoner, som er hardkodede funksjoner du ikke kan endre.

  • Brukerdefinerte funksjoner, som er delt inn i to typer:

    • Lagrede funksjoner: brukerdefinerte funksjoner som du lagrer og administrerer som databaseskjema-enheter, som tabeller. For mer informasjon om hvordan du oppretter og administrerer lagrede funksjoner, se oversikt over administrasjon av lagrede funksjoner.
    • Spørringsdefinerte funksjoner: brukerdefinerte funksjoner som du definerer og bruker innenfor rammen av en enkelt spørring. Du definerer disse funksjonene gjennom en let setning. For mer informasjon om hvordan du lager spørringsdefinerte funksjoner, se Lag en brukerdefinert funksjon.

I denne artikkelen lærer du hvordan du lager eller endrer en eksisterende lagret funksjon ved å bruke ..create-or-alterfunction

For mer informasjon om kommandoen .create-or-alterfunction , se .create-or-alter function.

Forutsetning

Opprett funksjoner

Denne funksjonen lar deg opprette eller endre en eksisterende funksjon ved å bruke kommandoen .create-or-alterfunction . Kommandoen lagrer funksjonen i databasemetadataene. Hvis funksjonen med den oppgitte funksjonsnavnet ikke finnes i databasemetadataene, oppretter kommandoen en ny funksjon. Ellers endrer kommandoen den navngitte funksjonen.

  1. Bla gjennom KQL-databasen din, og velg Ny>funksjon. Kommandoen .create-or-alter vises automatisk i vinduet Utforsk dataene dine .

    Skjermbilde av en KQL-database som viser nedtrekksmenyen for nye alternativer. Alternativet med tittelen Funksjon er markert.

  2. Skriv inn funksjonsnavnet og spørringsparameterne for funksjonen din i stedet for plassholderteksten, og velg deretter Kjør.

    Skjermbilde av vinduet Utforsk dine data som viser den nyopprettede funksjonen i Real-Time Intelligence.

    Lagrede funksjoner vises under Funksjoner i Utforsker-panelet .

    Skjermbilde av Utforsker-panelet som viser listen over lagrede brukerdefinerte funksjoner.

  3. I vinduet Utforsk dataene dine , kjør en spørring for å sjekke at du har laget eller endret funksjonen din.

    Skjermbilde av vinduet Utforsk dataene dine som viser spørringsresultater for en lagret funksjon i Real-Time Intelligence.

Liste over lagrede funksjoner

Du kan se en liste over alle lagrede funksjoner i databasen. Ved å venstreklikke på Funksjoner-alternativet eller ved å velge Vis funksjoner i rullegardinmenyen, kan du åpne listen over funksjoner.
Skjermbilde av funksjonstreet i Utforsker-panelet.

Listen inkluderer:

  • Funksjonens mappe og beskrivelse.
  • Valgfrie sorterings- og søkemuligheter for å hjelpe deg å finne spesifikke funksjoner.

Skjermbilde av listen over lagrede funksjoner.

Venstreklikk på en funksjon i listen åpner en skrivebeskyttet forhåndsvisningsversjon av funksjonen. I nedtrekksmenyen kan du også velge Vis funksjonen for å åpne forhåndsvisningsversjonen av funksjonen, redigere eller slette funksjonen.

Organiser funksjoner med mapper

For å opprette en undermappe eller flytte til en eksisterende mappe:

  1. I utforskerpanelet, enten:
    • Høyreklikk på funksjonen og velg Flytt til mappe>+ Ny mappe.
      Skjermbilde av popup-menyen som viser muligheten til å opprette en ny mappe for funksjonen.
    • Eller, velg ellipsen (...) ved siden av den spesifikke funksjonen og velg Flytt til mappe>+ Ny mappe , eller velg en eksisterende mappe.
      Skjermbilde av popup-menyen som viser muligheten til å flytte funksjonen til en eksisterende mappe eller opprette en ny.
  2. For å opprette en mappe, skriv inn et navn på mappen og velg Opprette. Funksjonen flyttes til den nye mappen.
    Skjermbilde av den nye mappen som opprettes.
  3. For å flytte mer enn én funksjon, må du enten skrive inn et annet mappenavn eller velge nedtrekksmenyen og krysse av i boksene ved siden av funksjonene du vil flytte til samme mappe.
    Skjermbilde av pop-up-menyen som viser muligheten til å flytte flere funksjoner til samme mappe.
  4. Du kan også flytte funksjoner til en eksisterende mappe. For å gjøre det, velg Flytt til mappe og deretter mappen du vil flytte funksjonen til, eller dra og slipp funksjonen inn i mappen.

Bemerkning

  • Hvis du sletter en undermappe, blir ikke funksjonene i mappen slettet, men flyttet tilbake til foreldremappen.
  • En undermappe slettes automatisk når det ikke finnes noen funksjoner i mappen.
  • Mapper kan opprettes per ressurstype, og navnet må være unikt per ressurstype. For eksempel kan du ha en table-mappe og en functions-mappe med samme navn, men du kan ikke ha to functions-mapper med samme navn.

Vis og forhåndsvisning av en lagret funksjon

For å se eller forhåndsvise en eksisterende lagret funksjon, følg disse trinnene:

  1. I Utforsker-panelet, utvid Funksjoner-seksjonen. Venstreklikk på ønsket funksjon for å åpne forhåndsvisningen eller velg de tre prikkene og vis-funksjonen.

  2. En skrivebeskyttet versjon av funksjonsskriptet åpnes i vinduet Utforsk dataene dine .

    • Du kan velge Forhåndsvisning av resultater for å forhåndsvise funksjonsresultatene.
    • Hvis funksjonen inkluderer parametere, kan du legge inn verdier for disse parameterne. Deretter velger du Forhåndsvisning av resultater for å se resultatet basert på parameterverdiene du har oppgitt.
    • Forhåndsvisningsresultatene viser opptil 100 poster basert på funksjonsspørringen.

    Skjermbilde av vinduet Utforsk dataene dine som viser et skript for lagret funksjon.

Rediger eller slett en lagret funksjon

For å redigere eller slette en eksisterende lagret funksjon, bruk følgende steg:

  1. I Utforsker-panelet, utvid Funksjoner-seksjonen. Velg de tre prikkene ved siden av ønsket funksjon.

  2. Velg enten fra rullegardinmenyen:

    • Rediger med kode for å redigere funksjonsskriptet i vinduet Utforsk dataene dine .
    • Slett

    Skjermbilde av nedtrekksmenyen.

  3. Hvis du har endret funksjonsskriptet, velg Kjør for å lagre endringene dine.

Relatert innhold

  • Last updated on