Freigeben über


Verwenden von Fabric-Notebooks mit Daten aus einer KQL-Datenbank

Notebooks sind sowohl lesbare Dokumente, die Beschreibungen und Ergebnisse der Datenanalyse enthalten, als auch ausführbare Dokumente, die zur Datenanalyse ausgeführt werden können. In diesem Artikel erfahren Sie, wie Sie mithilfe eines Fabric-Notebooks eine Verbindung mit Daten in einer KQL-Datenbank herstellen und Abfragen mit systemeigener KQL (Kusto Query Language) ausführen. Weitere Informationen zu Notebooks finden Sie unter Verwenden von Microsoft Fabric-Notebooks.

Es gibt zwei Möglichkeiten, Fabric-Notebooks mit Daten aus Ihrer KQL-Datenbank zu verwenden:

Voraussetzungen

Verwenden von Kusto-Codeausschnitten in einem Notebook

Fabric-Notebooks enthalten Codeausschnitte, mit denen Sie häufig verwendete Codemuster einfach schreiben können, darunter. Sie können Codeausschnitte verwenden, um Daten in einer KQL-Datenbank mithilfe von KQL zu schreiben oder zu lesen.

  1. Navigieren Sie zu einem vorhandenen Notebook oder erstellen Sie ein neues.

  2. Beginnen Sie in einer Codezelle mit der Eingabe von Kusto.

    Bildschirmaufnahme der Verwendung eines Kusto-Codeausschnitts zur Verwendung von KQL in einem Fabric-Notebook.

  3. Wählen Sie den Codeausschnitt aus, der dem auszuführenden Vorgang entspricht: Schreiben von Daten in eine KQL-Datenbank oder Lesen von Daten aus einer KQL-Datenbank.

    Der folgende Codeausschnitt zeigt den Beispieldatenlesevorgang:

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

    Der folgende Codeausschnitt zeigt den Beispiel-Datenschreibvorgang:

    # 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(kustoUri)
    
    # 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. Geben Sie die erforderlichen Informationen in die Anführungszeichen jedes Felds in der Datenzelle ein:

    Feld Beschreibung Verwandte Links
    kustoQuery Die zu bewertende KQL-Abfrage. Übersicht über KQL
    KustoUri Der Abfrage-URI Ihrer KQL-Datenbank. Kopieren eines KQL-Datenbank-URI
    database Der Name Ihrer KQL-Datenbank. Zugreifen auf eine vorhandene KQL-Datenbank
    data Die Daten, die in die Tabelle geschrieben werden sollen.
  5. Führen Sie die Codezelle aus.

Erstellen eines Notizbuchs aus einer KQL-Datenbank

Wenn Sie ein Notizbuch als verwandtes Element in einer KQL-Datenbank erstellen, erhält das Notizbuch denselben Namen wie die KQL-Datenbank und wird vorab mit Verbindungsinformationen aufgefüllt.

  1. Navigieren Sie zu Ihrer KQL-Datenbank.

  2. Wählen Sie Neues verwandtes Element>Notebook aus.

    Screenshot des Erstellens eines Notebooks als verwandtes Element in einer KQL-Datenbank.

    Ein Notebook wird mit den vorab aufgefüllten KustoUri- und Datenbankdetails erstellt.

  3. Geben Sie die KQL-Abfrage ein, die im KustoQuery-Feld ausgewertet werden soll.

    Screenshot des Notebooks, das aus einer KQL-Datenbank erstellt wird.

  4. Führen Sie die Codezelle aus.