Luo ja hallinnoi tallennettuja funktioita

Funktiot ovat uudelleenkäytettäviä kyselyitä tai kyselyosia. Reaaliaikainen tieto tukee kahdenlaisia funktioita:

• Sisäänrakennetut funktiot, jotka ovat kovakoodattuja ja joita ei voi muuttaa.

• Käyttäjän määrittämät funktiot, jotka on jaettu kahteen tyyppiin:

  • Tallennetut funktiot: käyttäjän määrittelemät funktiot, joita tallennat ja hallinnoit tietokantaskeemayksiköinä, kuten tauluina. Lisätietoja tallennettujen funktioiden luomisesta ja hallinnasta löytyy kohdasta Tallennettujen funktioiden hallinnan yleiskatsaus.
  • Kyselyn määrittelemät funktiot: käyttäjän määrittelemät funktiot, jotka määrittelet ja käytät yhden kyselyn puitteissa. Nämä funktiot määritellään lauseen let avulla. Lisätietoja kyselyjen määritellyistä funktioista löytyy kohdasta Käyttäjän määrittelemän funktion luominen.

Tässä artikkelissa opit, miten luoda tai muuttaa olemassa oleva tallennettu funktio käyttämällä ..create-or-alterfunction

Lisätietoja komennosta .create-or-alterfunction löytyy osoitteesta .create-or-alter function.

Edellytykset

• workspace jossa on Microsoft Fabric-yhteensopiva kapasiteetti
• KQL-tietokanta muokkausoikeuksilla

Luo funktioita

Tämän ominaisuuden avulla voit luoda tai muuttaa olemassa olevaa funktiota käyttämällä komentoa .create-or-alterfunction . Komento tallentaa funktion tietokannan metatietoihin. Jos funktio, jonka funktio on annettu Nimi , ei esiinny tietokannan metatiedoissa, komento luo uuden funktion. Muussa tapauksessa komento muuttaa nimettyä funktiota.

1. Selaa KQL-tietokantaasi ja valitse Uusi>toiminto. Komento .create-or-alter ilmestyy automaattisesti Tutki tietosi -ikkunassa.

   

2. Syötä funktion nimi ja kyselyparametrit funktiollesi paikkamerkkitekstin sijaan, ja valitse sitten Suorita.

   

   Tallennetut toiminnot näkyvät Resurssienhallinta-paneelin Toiminnot-kohdassa.

   

3. Tutki tietojasi -ikkunassa suorita kysely tarkistaaksesi, että olet onnistuneesti luonut tai muuttanut toimintosi.

   

Tallennettujen toimintojen luettelo

Voit nähdä listan kaikista tallennetuista funktioista tietokannassa. Klikkaamalla vasemmalla painikkeella Toiminnot -vaihtoehtoa tai valitsemalla Näytä funktiot pudotusvalikosta voit avata funktioluettelon.

Lista sisältää:

• Funktion kansio ja sen kuvaus.
• Valinnaiset lajittelu- ja hakutoiminnot, jotka auttavat löytämään tiettyjä toimintoja.

Vasemmalla klikkaamalla funktiota listassa avaa vain luku -esikatseluversio funktiosta. Pudotusvalikosta voit myös valita Näytä funktion avataksesi esikatseluversion, muokataksesi tai poistaaksesi funktion.

Järjestä funktioita kansioiden avulla

Alikansion luominen tai siirtäminen olemassa olevaan kansioon:

1. Explorer-ruudussa joko:
   • Napsauta toimintoa oikealla ja valitse Siirrä kansioon>+ Uusi kansio.
     
   • Tai valitse ellipsi (...) tietyn funktion vierestä ja valitse Siirrä kansioon>+ Uusi kansio tai valitse olemassa oleva kansio.
     
2. Luodaksesi kansion, syötä kansiolle nimi ja valitse Luo. Funktio siirretään uuteen kansioon.
   
3. Jos haluat siirtää useampaa funktiota, syötä toinen kansion nimi tai valitse pudotusvalikko ja rastita ruudut niiden funktioiden vieressä, jotka haluat siirtää samaan kansioon.
   
4. Voit myös siirtää funktioita olemassa olevaan kansioon. Tätä varten valitse Siirrä kansioon ja valitse sitten kansio, johon haluat siirtää funktion, tai vedä ja pudota funktio kansioon.

Näytä ja esikatsele tallennettu funktio

Jos haluat nähdä tai esikatsella olemassa olevaa tallennettua funktiota, noudata näitä vaiheita:

1. Explorer-paneelissa laajenna Functions-osio. Napsauta haluttua funktiota avataksesi esikatselun tai valitse kolme pistettä ja näytä toiminto.

2. Vain luku -versio funktioskriptistä avautuu Tutki datasi -ikkunassa.

   • Voit valita Preview tulokset esikatseluun funktion tulosten esikatseluun.
   • Jos funktio sisältää parametreja, voit syöttää arvoja niille parametreille. Valitse sitten Esikatselutulokset nähdäksesi tuloksen antamiesi parametriarvojen perusteella.
   • Esikatselutulokset näyttävät jopa 100 tietuetta funktiokyselyn perusteella.

   

Muokkaa tai poista tallennettu funktio

Muokkaaaksesi tai poistaaksesi olemassa olevan tallennetun funktion, käytä seuraavia vaiheita:

1. Explorer-paneelissa laajenna Functions-osio. Valitse kolme pistettä halutun funktion vierestä.

2. Valitse avattavasta valikosta jompikumpi seuraavista:

   • Muokkaa koodilla muokataksesi funktioskriptiä Tutki datasi -ikkunassa.
   • Poista

   

3. Jos muokkasit funktioskriptiä, valitse Suorita tallentaaksesi muutokset.

Liittyvä sisältö

• Tietojen kyseleminen KQL-kyselyjoukossa
• Muuta datakäytäntöjä
• Luo taulukkopäivityspolitiikka