Brug Fabric-notesbøger med data fra en KQL-database

Notesbøger er både læsbare dokumenter, der indeholder beskrivelser af dataanalyser og resultater og eksekverbare dokumenter, der kan køres for at udføre dataanalyse. I denne artikel lærer du, hvordan du bruger en Fabric-notesbog til at oprette forbindelse til data i en KQL-database og køre forespørgsler ved hjælp af oprindelig KQL (Kusto Query Language). Du kan få flere oplysninger om notesbøger under Sådan bruger du Microsoft Fabric-notesbøger.

Du kan bruge Fabric-notesbøger med data fra din KQL-database på to måder:

• Brug Kusto-kodestykker i en notesbog
• Opret en notesbog fra en KQL-database

Forudsætninger

• Et arbejdsområde med en Microsoft Fabric-aktiveret -kapacitet
• En KQL-database med mindst visningstilladelser

Brug Kusto-kodestykker i en notesbog

Fabric-notesbøger indeholder kodestykker, der hjælper dig med nemt at skrive almindeligt anvendte kodemønstre. Du kan bruge kodestykker til at skrive eller læse data i en KQL-database ved hjælp af KQL.

1. Gå til en eksisterende notesbog, eller opret en ny.

2. Begynd at skrive kustoi en kodecelle.

   

3. Vælg det kodestykke, der svarer til den handling, du vil udføre: Skriv data til en KQL-database eller Læs data fra en KQL-database.

   Følgende kodestykke viser handlingen for læsning af eksempeldata:

   # 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()
   

   Følgende kodestykke viser eksempelhandlingen for skrivning af data:

   # 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. Angiv de påkrævede oplysninger i anførselstegnene for hvert felt i datacellen:

   Mark	Beskrivelse	Relaterede links
   kustoQuery	Den KQL-forespørgsel, der skal evalueres.	KQL-oversigt
   KustoUri	Forespørgsels-URI'en for din KQL-database.	Kopiér en KQL-database-URI-
   database	Navnet på din KQL-database.	Få adgang til en eksisterende KQL-database
   data	De data, der skal skrives til tabellen.

5. Kør kodecellen.

Opret en notesbog fra en KQL-database

Når du opretter en notesbog som et relateret element i en KQL-database, får notesbogen samme navn som KQL-databasen og udfyldes på forhånd med forbindelsesoplysninger.

1. Gå til din KQL-database.

2. Vælg Nyt relateret element>Notesbog.

   

   Der oprettes en notesbog med KustoUri og databaseoplysninger udfyldt på forhånd.

3. Angiv den KQL-forespørgsel, der skal evalueres i feltet kustoQuery.

   

4. Kør kodecellen.

Relateret indhold

• KQL-oversigt
• Sådan bruger du Microsoft Fabric-notesbøger