Χρήση σημειωματάριων Fabric με δεδομένα από μια βάση δεδομένων KQL

Τα σημειωματάρια είναι ευανάγνωστα έγγραφα που περιέχουν περιγραφές ανάλυσης δεδομένων και αποτελέσματα και εκτελέσιμα έγγραφα που μπορούν να εκτελεστούν για την εκτέλεση ανάλυσης δεδομένων. Σε αυτό το άρθρο, θα μάθετε πώς μπορείτε να χρησιμοποιήσετε ένα σημειωματάριο Fabric για να συνδεθείτε σε δεδομένα σε μια βάση δεδομένων KQL και να εκτελέσετε ερωτήματα χρησιμοποιώντας εγγενή KQL (Γλώσσα ερωτημάτων Kusto). Για περισσότερες πληροφορίες σχετικά με τα σημειωματάρια, ανατρέξτε στο θέμα Τρόπος χρήσης σημειωματάριων Microsoft Fabric.

Υπάρχουν διάφοροι τρόποι για να χρησιμοποιήσετε σημειωματάρια Fabric με δεδομένα από τη βάση δεδομένων KQL:

• Φόρτωση δεδομένων βάσης δεδομένων KQL από τον κατάλογο OneLake
• Χρήση τμημάτων κώδικα Kusto σε σημειωματάριο
• Δημιουργία σημειωματάριου από μια βάσης δεδομένων KQL
• Αναλύστε δεδομένα σε μια βάση δεδομένων KQL με ένα νέο ή υπάρχον σημειωματάριο.

Προϋποθέσεις

• Ένας χώρος εργασίας με εκχωρημένους πόρους με δυνατότητα Microsoft Fabric
• Μια βάσης δεδομένων KQL με τουλάχιστον δικαιώματα προβολής

Φόρτωση δεδομένων βάσης δεδομένων KQL από τον κατάλογο OneLake

Οι βάσεις δεδομένων KQL στον κατάλογο OneLake είναι διαθέσιμες ως προελεύσεις δεδομένων στο περιβάλλον σημειωματαρίου. Μπορείτε να προσθέσετε μια βάση δεδομένων KQL ως προέλευση δεδομένων στο σημειωματάριό σας και, στη συνέχεια, να την αναφέρετε στα κελιά κώδικα για να εκτελέσετε ερωτήματα KQL σε αυτήν.

1. Στον χώρο εργασίας σας, μεταβείτε σε ένα υπάρχον σημειωματάριο ή δημιουργήστε ένα νέο.

2. Στο τμήμα παραθύρου Εξερεύνηση σημειωματαρίου, επιλέξτε Προσθήκη στοιχείων δεδομένων και, στη συνέχεια, επιλέξτε Από τον κατάλογο OneLake.

   

3. Στον κατάλογο OneLake, μεταβείτε στη βάση δεδομένων KQL. Μπορείτε να τη βρείτε κάτω από την αποθήκη συμβάντων στην οποία ανήκει, μπορείτε να φιλτράρετε τη λίστα κατά τύπο και να επιλέξετε Τύπος βάσης δεδομένων KQL ή μπορείτε να την αναζητήσετε με βάση το όνομα.

   

4. Η βάση δεδομένων KQL προστίθεται στο OneLake στο παράθυρο εξερεύνησης του σημειωματαρίου.

   1. Αναπτύξτε τη βάση δεδομένων για να δείτε τους πίνακες μέσα σε αυτήν.

   2. Τοποθετήστε τον δείκτη του ποντικιού επάνω σε έναν πίνακα, επιλέξτε το μενού Περισσότερα ... και, στη συνέχεια, επιλέξτε Φόρτωση δεδομένων.

      

5. Τα δεδομένα από τον πίνακα φορτώνονται σε ένα νέο κελί κώδικα στο σημειωματάριο και δημιουργείται αυτόματα μια σύνδεση με τη βάση δεδομένων KQL. Στη συνέχεια, μπορείτε να εκτελέσετε το κελί κώδικα για να υποβάλετε ερωτήματα στα δεδομένα και να επιστρέψετε αποτελέσματα στο σημειωματάριό σας.

   

Για περισσότερες πληροφορίες σχετικά με την εμπειρία του σημειωματάριου με δεδομένα KQL και τις επιλογές ανάλυσης δεδομένων, ανατρέξτε στο θέμα xxxxxxx.

Χρήση τμημάτων κώδικα Kusto σε σημειωματάριο

Τα σημειωματάρια Fabric παρέχουν τμήματα κώδικα που σας βοηθούν να γράφετε εύκολα μοτίβα κώδικα που χρησιμοποιούνται συχνά. Μπορείτε να χρησιμοποιήσετε τμήματα κώδικα για την εγγραφή ή ανάγνωση δεδομένων σε μια βάση δεδομένων KQL χρησιμοποιώντας KQL.

1. Μεταβείτε σε ένα υπάρχον σημειωματάριο ή δημιουργήστε ένα νέο.

2. Σε ένα κελί κώδικα, αρχίστε να πληκτρολογείτε kusto.

   

3. Επιλέξτε το τμήμα κώδικα που αντιστοιχεί στη λειτουργία που θέλετε να εκτελέσετε: Εγγραφή δεδομένων σε βάσης δεδομένων KQL ή Ανάγνωση δεδομένων από μια βάση δεδομένων KQL.

   Το παρακάτω τμήμα κώδικα εμφανίζει το παράδειγμα λειτουργίας ανάγνωσης δεδομένων:

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

   Το παρακάτω τμήμα κώδικα εμφανίζει το παράδειγμα λειτουργίας εγγραφής δεδομένων:

   # 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. Εισαγάγετε τις απαιτούμενες πληροφορίες στα εισαγωγικά κάθε πεδίου στο κελί δεδομένων:

   Αγρός	Περιγραφή	Σχετικές συνδέσεις
   kustoQuery	Το ερώτημα KQL προς αξιολόγηση.	επισκόπησης KQL
   KustoUri	Το URI ερωτήματος της βάσης δεδομένων KQL.	Αντιγραφή URI βάσης δεδομένων KQL
   βάση δεδομένων	Το όνομα της βάσης δεδομένων KQL.	Πρόσβαση σε μια υπάρχουσα βάσης δεδομένων KQL
   δεδομένα	Τα δεδομένα που θα εγγραφούν στον πίνακα.

5. Εκτελέστε το κελί κώδικα.

Δημιουργία σημειωματάριου από βάση δεδομένων KQL

Όταν δημιουργείτε ένα σημειωματάριο ως σχετικό στοιχείο σε μια βάση δεδομένων KQL, το σημειωματάριο λαμβάνει το ίδιο όνομα με τη βάση δεδομένων KQL και προ-συμπυκνώνεται με πληροφορίες σύνδεσης.

1. Μεταβείτε στη βάση δεδομένων KQL.

2. Επιλέξτε Νέο σχετικό στοιχείο>Σημειωματάριο.

   

   Δημιουργείται ένα σημειωματάριο με προσυμπλημένες τις λεπτομέρειες του KustoUri και της βάσης δεδομένων.

3. Εισαγάγετε το ερώτημα KQL που θα αξιολογηθεί στο πεδίο kustoQuery.

   

4. Εκτελέστε το κελί κώδικα.

Σχετικό περιεχόμενο

• επισκόπησης KQL
• Πώς μπορείτε να χρησιμοποιήσετε σημειωματάρια Microsoft Fabric
• Αναλύστε δεδομένα σε μια βάση δεδομένων KQL