Fabric-muistikirjojen käyttäminen KQL-tietokannan tietojen kanssa

Muistikirjat ovat sekä luettavissa olevia asiakirjoja, jotka sisältävät tietoanalyysin kuvauksia ja tuloksia sekä suoritettavia tiedostoja tietojen analysointia varten. Tässä artikkelissa kerrotaan, miten voit Fabric-muistikirjan avulla muodostaa yhteyden KQL-tietokannan tietoihin ja suorittaa kyselyitä käyttämällä alkuperäistä KQL (Kusto Query Language) -. Lisätietoja muistikirjoista on artikkelissa Microsoft Fabric -muistikirjojen käyttäminen.

On muutamia tapoja käyttää Fabric-muistikirjoja KQL-tietokannan datan kanssa:

Edellytykset

Lataa KQL-tietokantatiedot OneLake-katalogista

OneLake-katalogin KQL-tietokannat ovat saatavilla tietolähteinä muistikirjaympäristössä. Voit lisätä KQL-tietokannan tietolähteeksi muistikirjaasi ja viitata siihen koodisoluissasi ajaaksesi KQL-kyselyitä sitä vastaan.

  1. Workspacessasi siirry olemassa olevaan muistikirjaan tai luo uusi.

  2. Notebookin Explorer-paneelissa valitse Lisää tietokohteita ja valitse sitten OneLake-luettelosta.

    Kuvakaappaus muistikirjasta, jossa Explorer-paneeli on avoinna Data-elementit -välilehdellä. Lisää tietokohteita -painike laajennetaan ja valinta OneLake-katatlogista on korostettu.

  3. Siirry OneLake-katalogista KQL-tietokantaasi. Voit löytää sen Eventhousesta, johon se kuuluu, voit suodattaa listan tyypin mukaan ja valita KQL-tietokantatyypin, tai etsiä sitä nimellä.

    Kuvakaappaus OneLake-katalogisuodattimesta, jossa KQL-tietokantasuodatin on korostettu.

  4. KQL-tietokanta lisätään OneLaken alle muistikirjan resurssienhallintapaneeliin.

    1. Laajenna tietokantaa nähdäksesi sen taulut.

    2. Vie hiiri pöydän päälle, valitse enemmän ... valikko ja valitse sitten Lataa data.

      KQL:n tietokannan kuvakaappaus laajennettiin näyttämään sen taulukot. Taulukon lisävalikko laajenee näyttämään Lataa data -vaihtoehdon.

  5. Taulukon data ladataan uuteen koodisoluun muistikirjassa, ja yhteys KQL-tietokantaan muodostetaan automaattisesti. Voit sitten ajaa koodisolun kyselyyn datan ja palauttaa tulokset muistikirjassasi.

    Kuvakaappaus muistikirjasta sen jälkeen, kun KQL-tietokannan tiedot on ladattu. Koodipätkä on korostettu.

Lisätietoja kannettavan kokemuksesta KQL-datan kanssa ja data-analyysivaihtoehdoista löytyy osoitteesta xxxxxxx.

Kusto-katkelmien käyttö muistikirjassa

Kangasmuistikirjat tarjoavat koodikatkelmia joiden avulla voit helposti kirjoittaa usein käytettyjä koodimalleja. Voit käyttää katkelmia tietojen kirjoittamiseen tai lukemiseen KQL-tietokannassa KQL:n avulla.

  1. Siirry aiemmin luotuun muistikirjaan tai luo uusi muistikirja.

  2. Ala kirjoittaa koodisoluun kusto.

    näyttökuva kusto-katkelman käyttämisestä KQL:n käyttämiseen Fabric-muistikirjassa.

  3. Valitse katkelmia, jotka vastaavat toimintoa, jonka haluat suorittaa: Tietojen kirjoittaminen KQL-tietokannan tai Tietojen lukeminen KQL-tietokannan.

    Seuraavassa koodikatkelmassa näytetään esimerkki tietojen lukutoiminnosta:

    # Example of query for reading data from Kusto. Replace T with your <tablename>.
kustoQuery = "['T'] | take 10"
# The query URI for reading the data e.g. https://<>.kusto.data.microsoft.com.
kustoUri = "https://<yourKQLdatabaseURI>.z0.kusto.data.microsoft.com"
# The database with data to be read.
database = "DocsDatabase"
# The access credentials.
accessToken = mssparkutils.credentials.getToken('kusto')
kustoDf  = spark.read\
    .format("com.microsoft.kusto.spark.synapse.datasource")\
    .option("accessToken", accessToken)\
    .option("kustoCluster", kustoUri)\
    .option("kustoDatabase", database)\
    .option("kustoQuery", kustoQuery).load()

# Example that uses the result data frame.
kustoDf.show()

    Seuraavassa koodikatkelmassa on esimerkki tietojen kirjoittamisen toiminnosta:

    # The Kusto cluster uri to write the data. The query Uri is of the form https://<>.kusto.data.microsoft.com 
kustoUri = ""
# The database to write the data
database = ""
# The table to write the data 
table    = ""
# The access credentials for the write
accessToken = mssparkutils.credentials.getToken('kusto')

# Generate a range of 5 rows with Id's 5 to 9
data = spark.range(5,10) 

# Write data to a Kusto table
data.write.\
format("com.microsoft.kusto.spark.synapse.datasource").\
option("kustoCluster",kustoUri).\
option("kustoDatabase",database).\
option("kustoTable", table).\
option("accessToken", accessToken ).\
option("tableCreateOptions", "CreateIfNotExist").mode("Append").save()

  4. Anna tarvittavat tiedot kunkin kentän lainausmerkkeihin tietosolussa:

    Pelto Kuvaus Aiheeseen liittyvät linkit
    kustoQuery Arvioitava KQL-kysely. KQL:n yleiskatsaus
    KustoUri KQL-tietokannan kyselyn URI-osoite. KQL-tietokannan URI- kopioiminen
    tietokanta KQL-tietokannan nimi. Olemassa olevan KQL-tietokannan
    data Taulukkoon kirjoitettavat tiedot.

  5. Suorita koodisolu.

Muistikirjan luominen KQL-tietokannasta

Kun luot muistikirjan liittyvänä kohteena KQL-tietokannassa, muistikirjalle annetaan sama nimi kuin KQL-tietokannalle, ja se on täytetty etukäteen yhteystiimeillä.

  1. Selaa KQL-tietokantaan.

  2. Valitse Uusi liittyvä kohde>Notebook.

    Näyttökuva muistikirjan luomisesta liittyvänä kohteena KQL-tietokannassa.

    Muistikirja luodaan, ja KustoUri-tietokannan tiedot on täytetty valmiiksi.

  3. Anna kustoQuery -kentässä arvioitava KQL-kysely.

    Näyttökuva KQL-tietokannasta luodusta muistikirjasta.

  4. Suorita koodisolu.

Aiheeseen liittyvä sisältö

  • Last updated on