Tietojen kyseleminen KQL-kyselyjoukossa

Tässä artikkelissa opit käyttämään KQL-kyselyjoukkoa. KQL-kyselyjoukko on kohde, jota käytetään kyselyiden suorittamiseen, kyselyn tulosten tarkastelemiseen ja mukauttamiseen eri tietolähteistä, kuten Eventhousesta, KQL-tietokannasta ja niin edelleen.

KQL-kyselyjoukko käyttää Kusto-kyselykieltä kyselyiden luomiseen, ja se tukee myös monia SQL-funktioita. Lisätietoja kyselyn kielestä on kohdassa Kusto-kyselyn kielen yleiskatsaus.

Edellytykset

• Työtila, jossa on Microsoft Fabric -yhteensopiva kapasiteetti
• KQL-tietokanta, jossa on muokkausoikeudet ja tiedot, tai Azure Data Explorer -klusteri ja tietokanta, jolla on AllDatabaseAdmin-käyttöoikeudet.

Valitse tietolähde

Kyselyt suoritetaan tietolähteen kontekstissa. Voit muuttaa liittyvää tietolähdettä milloin tahansa ja säilyttää kyselyt, jotka on tallennettu kyselyeditoriin. Voit liittää KQL-kyselyjoukkosi useisiin erityyppisiin tietolähteisiin, kuten KQL-tietokantaan tai Azure Data Explorer -klusterin tietolähteeseen.

Valitse välilehti, joka vastaa haluamaasi tietolähdetyyppiä.

KQL-tietokanta

1. Avaa KQL-kyselyjoukko.

2. Laajenna tietolähdeyhteysvalikko tietokantavalitsimen avulla kyselysivun vasemmassa reunassa olevassa ruudussa kohdassa Explorer ja hakupalkissa.

   

3. Valitse Lisää tietolähde, ja valitse sitten OneLake-tietokeskus.

4. Valitse näkyviin tulevasta OneLake-tietokeskusikkunasta KQL-tietokanta KQL-kyselyjoukkoon yhdistämistä varten ja valitse sitten Yhdistä. Vaihtoehtoisesti voit sulkea OneLake -tietokeskuksen ikkunan ja muodostaa yhteyden toiseen tietolähteeseen käyttämällä + Lisää tietolähde -valikkoa.

Azure Data Explorer -klusteri

1. Avaa KQL-kyselyjoukko.

2. Laajenna tietolähdeyhteysvalikko tietokantavalitsimen avulla kyselysivun vasemmassa reunassa olevassa ruudussa kohdassa Explorer ja hakupalkissa.

   

3. Valitse Lisää tietolähdeja valitse sitten Azure Data Explorer.

4. Anna klusterin URI Kohdassa Yhteyden URI.

   Löydät yhteyden URI-liittymän siirtymällä klusteriresurssiin Azure-portaali. Yhteyden URI on yleiskatsauksesta löytyvä URI. Jos haluat lisätä maksuttoman malliklusterin, määritä yhteyden URI-parametriksi ohje.

   

5. Valitse Tietokanta-kohdasta avattava valikko, jolloin tietolähteiden luettelo klusterissasi laajentuu, ja valitse sitten tietolähde.

6. Valitse Yhdistä.

Tietolähteeseen liittyvien taulukoiden luettelo tulee näkyviin tietolähteen nimen alapuolelle.

Kyselyn kirjoittaminen

Nyt kun olet muodostanut yhteyden tietolähteeseen, voit suorittaa kyselyjä tiedoista. KQL-kyselyjoukko käyttää Kusto Query Languageä (KQL) tietojen kyselemiseen kaikista tietolähteistä, joihin sinulla on käyttöoikeus. Lisätietoja KQL :stä on kohdassa Kusto-kyselyn kielen yleiskatsaus.

Seuraavissa esimerkeissä käytetään tietoja, jotka ovat julkisesti saatavilla osoitteessa https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.

1. Kirjoita tai kopioi kysely KQL-kyselyjoukon yläruudussa.

2. Valitse Suorita-painike tai suorita kysely painamalla vaihtonäppäintä+Enter.

   Tulokseksi saatava kyselytulos näytetään tulosruudukossa, joka näkyy kyselyruudun alla. Huomaa vihreä tarkistus, joka ilmaisee, että kysely suoritettiin onnistuneesti, ja aika, joka käytettiin kyselyn tulosten laskemiseen.

   

Tietolähteiden käyttö

Tietolähteen hallinnan avulla voit vaihtaa tietolähteiden välillä, jotka on yhdistetty kyseiseen Kyselyjoukko-välilehteen.

Tietolähteen hallintaruudun yläreunan Explorer - voit etsiä tiettyä tietolähdettä hakupalkin avulla. Voit myös laajentaa tietolähdeyhteyksien valikon käyttämällä hakupalkin alapuolella olevaa tietokannan vaihtajaa. Valitse tietolähde, jota haluat käyttää. Jos välilehden nimeä ei ole muokattu aiemmin, se nimetään automaattisesti tietolähteen mukaan.

Tietolähteen hallintaruudussa on kaksi osaa. Yläosassa luetellaan kaikki tietolähteen kohteet. Alaosassa näkyvät kaikki kyselyjoukossa käytettävissä olevat tietolähteet.

Tietolähteen kohteet

Tietolähteen hallinnan yläosassa näkyvät kaikki kohteet, jotka sisältyvät käyttämääsi tietolähteeseen.

• Taulukot
• Muodostettu näkymä
• Pikakuvakkeet
• Toimintoja

Valitse haluamasi kohteen vasemmalla puolella oleva nuoli >. Voit porautua alaspäin nähdäksesi lisätietoja valitsemalla nuolen, joka > kohteiden vasemmalle puolelle seuraavilla luettelotasoilla. Esimerkiksi kohdassa Taulukot> taulukon vasemmalla puolella oleva nuoli, niin taulukon sarakkeiden luettelo tulee näkyviin.

Avaa toimintovalikko viemällä hiiren osoitin laajennetun luettelon kohteen päälle ja valitsemalla Lisää toimintoja -valikon [...]. Valikossa on seuraavat vaihtoehdot:

• Päivitä tietokanta
• Näytä tietoprofiili
• Lisää: komentosarjan luomiseen ja kopioimiseen
• Nouda tiedot: uuden tietolähteen lisääminen
• Koontinäytön luominen
• Poista taulukko

Eri kohdetyypeille on käytettävissä eri toimintoja.

Käytettävissä olevat tietolähteet

Tietolähteen hallinnan alaosassa näkyvät kaikki käytettävissä olevat tietolähteet, jotka on lisätty kyselyjoukkoon.

Avaa toimintovalikko viemällä hiiren osoitin tietolähteen nimen päälle ja valitsemalla Lisää toimintoja valikosta [...]. Valikossa on seuraavat vaihtoehdot:

• Päivitä tietokanta
• Käytä tätä tietokantaa: siirry käyttämään tätä tietolähdettä nykyisessä välilehdessä
• Kysely uudessa välilehdessä: avaa tämä tietolähde kyselyjoukon uudessa välilehdessä
• Poista lähde: poistaa kaikki kyseisen tietolähteen tietokannat
• Tietokannan poistaminen: poistaa vain valitun tietokannan

Kopioi kysely

Haluat ehkä kopioida ja jakaa luomasi kyselyt.

1. Valitse kyselyikkunan yläreunassa Aloitus-välilehti.

2. Valitse kyselyruudussa Kopioi kysely.

   

   Seuraavassa taulukossa esitetään kyselyn kopioimisen monet vaihtoehdot.

   Toimi	Kuvaus
   Kopioi kysely	Kopioi kyselyn teksti.
   Linkki leikepöydälle	Kopioi syvä linkki, jota voidaan käyttää kyselyn suorittamiseen.
   Linkitä ja tee kysely leikepöydälle	Kopioi linkki, jota voidaan käyttää kyselyn ja kyselyn tekstin suorittamiseen.
   Linkitä, tee kysely ja tulokset leikepöydälle	Kopioi linkki, jota voidaan käyttää kyselyn suorittamiseen, kyselyn tekstiin ja kyselyn tuloksiin.
   Kopioi tulokset	Kopioi kyselyn tulokset.

3. Valitse haluamasi toiminto luettelosta.

4. Voit muokata tai jakaa tietoja liittäen niitä esimerkiksi Microsoft Wordissa, Microsoft Teamsissa tai Outlookissa.

   Tärkeä

   Kyselylinkin saavalla käyttäjällä on oltava pohjana olevien tietojen tarkasteluoikeudet kyselyn suorittamiseksi ja tulosten tarkastelemiseksi.

Kyselyjoukon välilehtien hallinta

KQL-kyselyjoukossa voit luoda useita välilehtiä. Jokainen välilehti voidaan liittää eri KQL-tietokantaan, ja voit tallentaa kyselyt myöhempää käyttöä varten tai jakaa niitä muiden kanssa tietojen tutkimista varten. Voit myös muuttaa mitä tahansa välilehteen liitettyä KQL-tietokantaa, jolloin voit suorittaa saman kyselyn eri tietokannoissa.

Voit hallita välilehtiä seuraavilla tavoilla:

• Muuta aiemmin luotua tietolähdeyhteyttä: Laajenna tietolähteen yhteysvalikko Explorerin ja hakupalkissa tietokannan valitsimen avulla.
• välilehden nimeäminen uudelleen: Valitse välilehden nimen vieressä kynäkuvake.
• Lisää uusi välilehti -: Valitse komentopalkin olemassa olevien välilehtien oikealta puolelta plus-+. Eri välilehtiä voidaan yhdistää eri tietolähteisiin.
• Lisää toimintoja -: Komentopalkin oikealla puolella on välilehtivalikko, jossa on lisää toimintoja kyselyjoukon useiden välilehtien hallitsemiseksi.
• Muuta välilehtien sijainteja: Käytä vedä ja pudota -eleitä.

Vie kyselytiedot CSV-muodossa

Sen sijaan, että vain kopioisit ja liittäisit kyselyn tulokset, voit myös viedä kyselyn tulokset.

Tämä on kertaluonteinen menetelmä kyselyn tulokset sisältävän CSV-tiedoston viemiseen.

1. Valitse kyselyikkunan yläreunassa Aloitus-välilehti.

   

2. Valitse kyselyruudussa Vie CSV-tiedostoon.

3. Tallenna CSV-tiedosto paikallisesti.

Poista KQL-kyselyjoukko

KQL-kyselyjoukon poistaminen:

1. Valitse työtila, jossa KQL-kyselyjoukkosi sijaitsee.

2. Vie hiiren osoitin sen KQL-kyselyjoukon päälle, jonka haluat poistaa. Valitse Lisää [...]ja valitse sitten Poista.

   

Seuraava vaihe

Tulosten mukauttaminen KQL-kyselyjoukon tulosruudukossa