Azure Data Explorer (Kusto) ja KQL-tietokanta

Yhteenveto

Ominaisuus	Arvo
Connector	Azure Data Explorer (Kusto) KQL-tietokanta
Tuotteet	Azure Data Explorer (Kusto): Excel Power BI (semanttiset mallit) Power Query Online KQL-tietokanta: Power BI (semanttiset mallit) Power Query Online
Julkaisun tila	Esikatselu (KQL-tietokanta) ja yleinen saatavuus (Azure Data Explorer (Kusto))
Kategoria	Azure ja Fabric
Todennuslajit	Microsoft Entra ID
Tietolähdetyyppi	AzureDataExplorer
Funktioiden viitedokumentaatio	AzureDataExplorer.Contents AzureDataExplorer.Databases AzureDataExplorer.KqlDatabase

edellytykset

Azure Data Explorer (Kusto)

• Azure-tilaus. Siirry kohtaan Hanki ilmainen Azure-kokeiluversio.

• Organisaation sähköpostitili, joka on Microsoft Entra ID:n jäsen. Tässä artikkelissa käytetään tätä tiliä yhteyden muodostamiseen Azure Data Explorer -ohjeklusterimalleihin .

KQL-tietokanta

Sinulla täytyy olla lukuoikeudet KQL-tietokannassa.

Tuetut ominaisuudet

• Tuo
• DirectQuery (semanttiset Power BI -mallit)
• Lisäasetukset
  • Kyselyn tuloksen tietueen numeron rajoittaminen
  • Kyselyn tuloksen tietojen koon rajoittaminen tavuina
  • Poista tulosjoukon katkaisu käytöstä
  • Muut joukkolausekkeet

Parametrit

Azure Data Explorer (Kusto)

Aloituskohta:AzureDataExplorer.Contents

Vaadittujen parametrien määrä: 1

Tuo tiedot Azure Data Explorer (Kusto)

Tuo tiedot Azure Data Explorer (Kusto) esiintymästä

Kentät kohteessa options

KQL-tietokanta

Aloituskohta:AzureDataExplorer.KqlDatabase

Vaadittujen parametrien määrä: 0

Tuo tietoja Fabric Kusto -klusterista etsintätilassa.

Tietojen tuominen KQL-tietokantaesiintymästä

Kentät kohteessa options

Yhdistäminen Power Query Desktopista

Azure Data Explorer (Kusto)

Yhteyden muodostaminen Azure Data Exploreriin Power Query Desktopista:

1. Valitse Azure Data Explorer (Kusto) tietojen noutokokemuksessa. Power Query Desktopin Nouda tiedot -käyttökokemus vaihtelee sovellusten välillä. Lisätietoja Power Query Desktopista saat sovelluksen tietojen käyttökokemuksesta artikkelista Mistä tiedot noudataan.

2. Anna Azure Data Explorer (Kusto) -klusterin nimi. Käytä tässä esimerkissä https://help.kusto.windows.net malliohjeklusteria. Muissa klustereissa URL-osoite on muodossa https:// <ClusterName>.<Alue.kusto.windows.net>.

   Voit myös valita tietokannan, jota isännöidään klusterissa, johon muodostat yhteyden, ja jonkin tietokannan taulukoista tai kyselyn, kuten StormEvents | take 1000.

3. Jos haluat käyttää lisäasetuksia, valitse vaihtoehto ja syötä kyseisen vaihtoehdon kanssa käytettävät tiedot. Lisätietoja: Yhteyden muodostaminen lisäasetusten avulla

   Note

   Sinun on ehkä vieritettävä alaspäin, jotta näet kaikki lisäasetukset ja tietoyhteyden valinnan.

4. Valitse joko tuonti - tai DirectQuery-tietoyhteystila (vain Power BI Desktop). Lisätietoja: Milloin kannattaa käyttää tuonti- tai DirectQuery-tilaa?

5. Jatka valitsemalla OK .

   

6. Jos sinulla ei vielä ole yhteyttä klusteriin, valitse Kirjaudu sisään. Kirjaudu sisään organisaatiotilillä ja valitse sitten Yhdistä.

   

7. Valitse siirtymistoiminnossa haluamasi tietokannan tiedot ja valitse sitten Lataa ladataksesi tiedot tai Muunna tiedot , jos haluat jatkaa tietojen muuntamista Power Query editorissa. Tässä esimerkissä StormEvents valittiin Mallit-tietokannasta.

   

KQL-tietokanta

Yhdistääksesi KQL-tietokantaan Power Query Desktopista:

1. Get Data -toiminnossa valitse Microsoft Fabric (esikatselu) tai hae KQL, valitse KQL Database ja sitten Yhdistä. Lisätietoja: Tietojen hakeminen

   

2. KQL-tietokannassa täytä klusteri ja mahdolliset valinnaiset kentät, kuten Tietokanta.

   

   Saadaksesi klusterin URI:n, siirry KQL-tietokantaan Fabric-palvelussa ja kopioi Query URI.

   

   Valitse sitten OK.

3. Jos tämä yritys on ensimmäinen kerra, kun yhdistät tähän sivustoon, valitse Kirjaudu sisään ja syötä tunnuksesi. Valitse Yhdistä.

   

4. Navigatorissa valitse tarvitsemasi taulukot ja lataa tai muunna data.

   

Yhdistäminen Power Query Onlinesta

Azure Data Explorer (Kusto)

Yhteyden muodostaminen Azure Data Exploreriin Power Query Onlinesta:

1. Valitse Azure Data Explorer (Kusto) -vaihtoehto tietojen noutokokemuksessa. Eri sovelluksilla on eri tapoja päästä Power Query Onlinen tietojen noutamiseen. Lisätietoja siitä, miten pääset Power Query Onlinen tietojen noutamiseen sovelluksestasi, on kohdassa Mistä tiedot noudataan.

   

2. Anna Yhdistä tietolähteeseen -kohdassa Azure Data Explorer -klusterin nimi. Käytä tässä esimerkissä https://help.kusto.windows.net malliohjeklusteria. Muissa klustereissa URL-osoite on muodossa https:// <ClusterName>.<Alue.kusto.windows.net>.

   Voit myös valita tietokannan, jota isännöidään klusterissa, johon muodostat yhteyden, ja jonkin tietokannan taulukoista tai kyselyn, kuten StormEvents | take 1000.

   

3. Jos haluat käyttää lisäasetuksia, valitse vaihtoehto ja syötä kyseisen vaihtoehdon kanssa käytettävät tiedot. Lisätietoja: Yhteyden muodostaminen lisäasetusten avulla

4. Valitse tarvittaessa paikallinen tietoyhdyskäytävä tietoyhdyskäytävästä.

5. Jos sinulla ei vielä ole yhteyttä klusteriin, valitse Kirjaudu sisään. Kirjaudu sisään organisaatiotilillä.

6. Kun olet kirjautunut sisään, valitse Seuraava.

7. Valitse Valitse tiedot -sivulla haluamasi tietokannan tiedot ja jatka sitten tietojen muuntamista Power Query editorissa valitsemalla Muunna tiedot tai Seuraava . Tässä esimerkissä StormEvents valittiin Mallit-tietokannasta.

   

KQL-tietokanta

Yhdistääksesi KQL-tietokantaan Power Query Onlinesta:

1. Valitse tietolähde -osiossa hae KQL ja valitse sitten KQL Database. Lisätietoja: Tietojen hakeminen

2. Yhdistä tietolähteeseen -osiossa täytä klusteri ja mahdolliset valinnaiset kentät, kuten Tietokanta.

   

   Saadaksesi klusterin URI:n, siirry KQL-tietokantaan Fabric-palvelussa ja kopioi Query URI.

   

3. Tarvittaessa syötä paikallinen dataportti, jos aiot käyttää paikallista dataa. Esimerkiksi, jos aiot yhdistää dataa datavirroista ja paikallisesta SQL Server -tietokannasta.

4. Kirjaudu sisään organisaatiotilillesi.

5. Kun olet kirjautunut sisään onnistuneesti, valitse Seuraava.

6. Valitse Data-osiossa tarvitsemasi data ja valitse sitten Muunna Data.

   

Lisätietoja

Lisäasetukset

Sekä Power Query Desktop että Power Query Online tarjoavat joukon lisäasetuksia, joita voit tarvittaessa lisätä kyselyäsi.

Seuraavassa taulukossa on luettelo kaikista lisäasetuksista, jotka voit määrittää Power Query Desktopissa ja Power Query Onlinessa.

Lisätietoja lisäasetuksista, jotka eivät ole käytettävissä Power Query käyttöliittymässä, on kohdassa Azure Data Explorer -yhdistimen asetusten määrittäminen M-kyselyssä.

Milloin kannattaa käyttää tuonti- tai DirectQuery-tilaa?

Tuontitilassa tiedot siirretään Power BI:hin. DirectQuery-tilassa tietoja kysellään suoraan klusterista.

Käytä tuontitilaa, kun:

• Tietojoukkosi on pieni.
• Et tarvitse lähes reaaliaikaista dataa.
• Tietosi on jo koottu tai suoritat koosteen Kustossa.

Käytä DirectQuery-tilaa, kun:

• Tietojoukkosi on erittäin suuri.
• Tarvitset lähes reaaliaikaista dataa.

Lisätietoja DirectQueryn käyttämisestä on kohdassa Tietoja DirectQueryn käyttämisestä Power BI:ssä.

Vihjeitä tietojen kyselemiseen

Seuraavissa osissa on vinkkejä ja niksejä Kusto-kyselykielen käyttämiseen Power Query kanssa.

Monimutkaiset kyselyt Power BI:ssä

Monimutkaiset kyselyt ilmaistaan helpommin Kustossa kuin Power Query. Ne tulee toteuttaa Kusto-funktioina ja kutsua Power BI:ssä. Tämä menetelmä on pakollinen, kun käytät DirectQueryä Kusto-kyselyn lausekkeiden kanssa let . Koska Power BI yhdistää kaksi kyselyä eikä let lausekkeita voi käyttää operaattorin join kanssa, syntaksivirheitä saattaa ilmetä. Tallenna siksi liitoksen jokainen osa Kusto-funktiona ja anna Power BI:n liittää nämä kaksi funktiota yhteen.

Suhteellisen päivämäärä-aika-operaattorin simulointi

Power Query ei sisällä suhteellista päivämäärä-aika-operaattoria, kuten ago(). Voit simuloida ago()käyttämällä DateTime.FixedLocalNow - ja #duration Power Query M-funktioiden yhdistelmää.

Tämän kyselyn sijaan operaattorin ago() avulla:

    StormEvents | where StartTime > (now()-5d)
    StormEvents | where StartTime > ago(5d)

Käytä seuraavaa vastaavaa kyselyä:

let
    Source = AzureDataExplorer.Contents("help", "Samples", "StormEvents", []),
    #"Filtered Rows" = Table.SelectRows(Source, each [StartTime] > (DateTime.FixedLocalNow()-#duration(5,0,0,0)))
in
    #"Filtered Rows"

Azure Data Explorer -yhdistimen asetusten määrittäminen M-kyselyssä

Voit määrittää Azure Data Explorer -liittimen asetukset Power Query laajennetusta editorista M-kyselykielellä. Näiden asetusten avulla voit hallita luotua kyselyä, joka lähetetään Azure Data Explorer -klusteriin.

let
    Source = AzureDataExplorer.Contents("help", "Samples", "StormEvents", [<options>])
in
    Source

Voit käyttää M-kyselyssä mitä tahansa seuraavista vaihtoehdoista:

Kusto-kyselyrajojen saavuttaminen

Kusto-kyselyt palauttavat oletusarvoisesti enintään 500 000 riviä tai 64 Mt kyselyrajoituksissa kuvatulla tavalla. Voit ohittaa nämä oletusarvot käyttämällä Lisäasetukset Azure Data Explorer (Kusto) -yhteysikkunassa:

Nämä asetukset antavat kyselyn kanssa joukkolausekkeita kyselyn oletusrajoitusten muuttamiseksi:

• Rajoita kyselyn tuloksen tietuenumeroa luo set truncationmaxrecords
• Rajoita kyselyn tuloksen tietojen kokoa tavuina luo set truncationmaxsize
• Poista tulosjoukon katkaisu käytöstä luo set notruncation

Kirjainkoon merkitsevyys

Liitin luo oletusarvoisesti kyselyitä, jotka käyttävät kirjainkoolla merkitystä - == operaattoria verrattaessa merkkijonoarvoja. Jos tiedoissa kirjainkoolla ei ole merkitystä, tämä ei ole toivottu toiminta. Jos haluat muuttaa luotua kyselyä, käytä yhdistinvaihtoehtoa CaseInsensitive :

let
    Source = AzureDataExplorer.Contents("help", "Samples", "StormEvents", [CaseInsensitive=true]),
    #"Filtered Rows" = Table.SelectRows(Source, each [State] == "aLaBama")
in
    #"Filtered Rows"

Kyselyparametrien käyttäminen

Kyselyparametrien avulla voit muokata kyselyä dynaamisesti.

Kyselyparametrin käyttäminen kyselyn vaiheissa

Voit käyttää kyselyparametria missä tahansa kyselyvaiheessa, joka tukee sitä. Voit esimerkiksi suodattaa tulokset parametrin arvon perusteella. Valitse tässä esimerkissä avattava valikko sarakkeen oikeassa reunassa State Power Query editori, valitse Tekstisuodattimet>yhtä suuri kuin ja valitse sitten ALABAMA kohdassa Säilytä rivit, joissa "Osavaltio".

Parametrien antaminen Azure Data Explorer -funktiolle

Kusto-funktiot ovat erinomainen tapa ylläpitää monimutkaisia Kusto Query Language (KQL) -kyselyitä. Suosittelemme käyttämään funktioita KQL:n upottamisen sijaan Power Query. Funktion käytön tärkein etu on, että logiikkaa ylläpidetään kerran ympäristössä, joka on helppo luoda ja testata.

Funktiot voivat myös vastaanottaa parametreja, mikä lisää paljon joustavuutta Power BI -käyttäjälle. Power BI:ssä on monia tapoja osittaa tietoja. Kaikki suodattimet ja osittajat lisätään kuitenkin alkuperäisen KQL:n jälkeen, ja monissa tapauksissa suodatusta kannattaa käyttää kyselyn varhaisessa vaiheessa. Funktioiden ja dynaamisten parametrien käyttäminen on erittäin tehokas tapa mukauttaa lopullista kyselyä.

Funktion luominen

Voit luoda seuraavan funktion missä tahansa Azure Data Explorer -klusterissa, johon sinulla on käyttöoikeus, mukaan lukien maksuton klusteri. Funktio palauttaa taulukon SalesTable ohjeklusterista, joka on suodatettu myyntitapahtumille, jotka ovat suurempia tai pienempiä kuin raportin käyttäjän antama luku.

.create-or-alter  function LargeOrSmallSales(Cutoff:long,Op:string=">")
{
    cluster("help").database("ContosoSales").SalesTable
    | where  (Op==">" and SalesAmount >= Cutoff) or (Op=="<"  and SalesAmount <= Cutoff)
}

Kun olet luonut funktion, voit testata sitä seuraavilla tavoilla:

LargeOrSmallSales(2000,">")
| summarize Sales=tolong(sum(SalesAmount)) by Country

Voit myös testata sitä käyttämällä:

LargeOrSmallSales(20,"<")
| summarize Sales=tolong(sum(SalesAmount)) by Country

Funktion käyttäminen Power BI:ssä

1. Muodosta yhteys klusteriin, jossa loit funktion.

2. Valitse Power Query siirtymistoiminnossa funktio objektiluettelosta. Liitin analysoi parametrit ja esittää ne tietojen yläpuolella navigaattorin oikealla puolella.

   

3. Lisää arvot parametreihin ja valitse sitten Käytä.

4. Kun esikatselu tulee näkyviin, valitse Muunna tiedot.

5. Kun olet Power Query editorissa, luo kaksi parametria, yksi raja-arvolle ja toinen operaattorille.

6. Palaa kyselyyn LargeOrSmallSales ja korvaa arvot kaavarivin kyselyparametreilla.

   

7. Luo editorissa kaksi staattista taulukkoa (Anna tiedot), jotka tarjoavat vaihtoehtoja kahdelle parametrille. Rajaa varten voit luoda taulukon, jonka arvot ovat esimerkiksi 10, 50, 100, 200, 500, 1000, 2000. TaulukossaOp, jossa on kaksi Teksti-arvoa < ja .>

8. Taulukoiden kaksi saraketta on sidottava kyselyparametreihin käyttämällä Sido parametriin -valintaa.

   

Loppuraportti sisältää osittajat kahdelle staattiselle taulukolle ja kaikki visualisoinnit yhteenvedosta.

Perustaulukko suodatetaan ensin ja kootaan sitten.

Kyselyparametrin käyttäminen yhteystiedoissa

Kyselyparametrin avulla voit suodattaa kyselyn tietoja ja optimoida kyselyn suorituskyvyn.

Edistyneessä editorissa:

1. Etsi kyselyn seuraava osa:

   Lähde = AzureDataExplorer.Contents("<Klusteri>", "<Tietokanta>", "<Kysely>", [])

   Esimerkki:

   Source = AzureDataExplorer.Contents("Help", "Samples", "StormEvents | where State == 'ALABAMA' | take 100", [])
   

2. Lisää kyselyparametri Kusto Query Language (KQL) -kyselyyn.

   Jos liität KQL-kyselyn suoraan yhteysvalintaikkunaan, kysely on osa lähdevaihetta Power Query. Voit upottaa parametreja osana kyselyä lisäeditorin avulla tai muokatessasi lähdelauseketta kaavarivillä. Esimerkkikysely voisi olla StormEvents | where State == ' " & State & " ' | take 100. State on parametri ja suorituksen aikana kysely on:

   StormEvents | where State == 'ALABAMA' | take 100

3. Jos kyselyssä on lainausmerkkejä, koodaa ne oikein. Esimerkiksi seuraava kysely KQL:ssä:

   "StormEvents | where State == "ALABAMA" | take 100"
   

   näkyvät Edistyneessä editorissa seuraavasti kahdella lainausmerkillä:

    "StormEvents | where State == ""ALABAMA"" | take 100"
   

   Jos käytät parametria, kuten State, se on korvattava seuraavalla kyselyllä, joka sisältää kolme lainausmerkkiä:

   "StormEvents | where State == """ & State & """ | take 100"
   

Value.NativeQueryn käyttäminen Azure Data Explorer -ominaisuuksissa

Jos haluat käyttää Azure Data Explorer -ominaisuutta, jota Power Query ei tueta, käytä Power Query M:n Value.NativeQuery-menetelmää . Tämä menetelmä lisää Kusto-kyselykielen osan luotuun kyselyyn, ja sen avulla voit myös hallita suoritettua kyselyä paremmin.

Seuraavassa esimerkissä näytetään, miten funktiota percentiles käytetään Azure Data Explorerissa:

let
    StormEvents = AzureDataExplorer.Contents(DefaultCluster, DefaultDatabase){[Name = DefaultTable]}[Data],
    Percentiles = Value.NativeQuery(StormEvents, "| summarize percentiles(DamageProperty, 50, 90, 95) by State")
in
    Percentiles

Älä käytä Power BI:n tietojen päivityksen ajoitusta ohjauskomentojen antamiseen Kustolle

Power BI sisältää tietojen päivityksen ajoituksen, joka voi lähettää ajoittain kyselyitä tietolähteeseen. Tätä mekanismia ei tule käyttää ohjauskomentojen ajoittamiseen Kustoon, koska Power BI olettaa, että kaikki kyselyt ovat vain luku -tilassa.