Verwenden von Fabric-Notizbüchern mit Daten aus einer KQL-Datenbank

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

Es gibt einige Möglichkeiten, Fabric Notizbücher mit Daten aus Ihrer KQL-Datenbank zu verwenden:

Voraussetzungen

Laden von KQL-Datenbankdaten aus dem OneLake-Katalog

Die KQL-Datenbanken im OneLake-Katalog sind als Datenquellen in der Notizbuchumgebung verfügbar. Sie können Ihrem Notizbuch eine KQL-Datenbank als Datenquelle hinzufügen und dann in Ihren Codezellen darauf verweisen, um KQL-Abfragen auszuführen.

  1. Navigieren Sie in Ihrem Arbeitsbereich zu einem vorhandenen Notizbuch, oder erstellen Sie ein neues Notizbuch.

  2. Wählen Sie im Explorer-Bereich des Notizbuchs Die Option "Datenelemente hinzufügen " und dann " Aus OneLake-Katalog" aus.

    Screenshot eines Notizbuchs mit geöffnetem Explorer-Bereich auf der Registerkarte

  3. Navigieren Sie im OneLake-Katalog zu Ihrer KQL-Datenbank. Sie finden es unter dem Eventhouse, zu dem es gehört, Sie können die Liste nach Typ filtern und den KQL-Datenbanktyp auswählen, oder Sie können nach dem Namen danach suchen.

    Screenshot des OneLake-Katalogfilters mit hervorgehobenem KQL-Datenbankfilter.

  4. Die KQL-Datenbank wird unter OneLake im Explorer-Bereich des Notizbuchs hinzugefügt.

    1. Erweitern Sie die Datenbank, um die darin enthaltenen Tabellen anzuzeigen.

    2. Zeigen Sie mit der Maus auf eine Tabelle, wählen Sie das Menü "Mehr..." aus, und wählen Sie dann " Daten laden" aus.

      Screenshot einer erweiterten KQL-Datenbank, um die zugehörigen Tabellen anzuzeigen. Das Menü

  5. Die Daten aus der Tabelle werden in eine neue Codezelle im Notizbuch geladen, und eine Verbindung mit der KQL-Datenbank wird automatisch hergestellt. Anschließend können Sie die Codezelle ausführen, um die Daten abzufragen und Ergebnisse in Ihrem Notizbuch zurückzugeben.

    Screenshot des Notizbuchs nach dem Laden von Daten aus der KQL-Datenbank. Der Codeausschnitt ist hervorgehoben.

Weitere Informationen zur Notizbucherfahrung mit KQL-Daten und den Datenanalyseoptionen finden Sie unter xxxxxxx.

Verwenden von Kusto-Codeausschnitten in einem Notizbuch

Fabric-Notizbücher stellen Codeausschnitte bereit, mit denen Sie häufig verwendete Codemuster problemlos schreiben können. 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 Notizbuch, oder erstellen Sie ein neues Notizbuch.

  2. Beginnen Sie in einer Codezelle mit der Eingabe kusto.

    Bildschirmaufnahme der Verwendung eines Kusto-Codeausschnitts, um KQL in einem Fabric-Notizbuch zu nutzen.

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

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

    Feld Beschreibung Verwandte Links
    kustoQuery Die auszuwertende 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
    Daten 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 Notizbuchs als verwandtes Element in einer KQL-Datenbank.

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

  3. Geben Sie die KQL-Abfrage ein, die im feld kustoQuery ausgewertet werden soll.

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

  4. Führen Sie die Codezelle aus.

Verwandte Inhalte

  • Last updated on