Verwenden der KQL-Aktivität zum Ausführen einer Abfrage

Mit der KQL-Aktivität in Data Factory für Microsoft Fabric können Sie eine Abfrage in der Kusto-Abfragesprache (KQL) für eine Azure Data Explorer-Instanz ausführen.

Voraussetzungen

Um zu beginnen, müssen die folgenden Voraussetzungen erfüllt sein:

Hinzufügen einer KQL-Aktivität zu einer Pipeline über die Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um eine KQL-Aktivität in einer Pipeline zu verwenden:

Erstellen der Aktivität

  1. Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.

  2. Suchen Sie im Bereich Aktivitäten der Pipeline nach „KQL“, und fügen Sie diese Aktivität auf dem Pipelinecanvas hinzu.

    Hinweis

    Möglicherweise müssen Sie das Menü erweitern und nach unten scrollen, um die KQL-Aktivität wie im folgenden Screenshot hervorgehoben anzuzeigen.

    Screenshot der Fabric-Benutzeroberfläche mit hervorgehobener Aktivität

  3. Wählen Sie die neue KQL-Aktivität auf dem Pipeline-Editor-Canvas aus, wenn sie noch nicht ausgewählt ist.

    Screenshot der Registerkarte

Informationen zum Konfigurieren der Registerkarte Allgemein finden Sie unter Allgemeine Einstellungen.

Einstellungen der KQL-Aktivität

  1. Wählen Sie die Registerkarte "Einstellungen " und dann Ihre KQL-Datenbankverbindung aus der Dropdownliste aus, oder erstellen Sie eine neue. Wenn Sie einen Arbeitsbereichsdatenspeicher auswählen, können Sie dynamische Inhalte verwenden, um die Datenbankauswahl zu parametrisieren, indem Sie die Option Dynamischen Inhalt hinzufügen auswählen, die in der Dropdownliste angezeigt wird.

  2. Stellen Sie dann eine KQL-Abfrage bereit, die für die ausgewählte Datenbank für die Eigenschaft Command ausgeführt werden soll. Sie können dynamische Inhalte in der Abfrage verwenden, indem Sie den Link Dynamischen Inhalt hinzufügen auswählen, der angezeigt wird, wenn das Textfeld ausgewählt ist.

    Screenshot der Registerkarte

  3. Geben Sie schließlich ein Befehlstimeout an, oder behalten Sie das Standardtimeout von 20 Minuten bei. Sie können dynamische Inhalte auch für diese Eigenschaft verwenden.

Speichern und Ausführen oder Planen der Pipeline

Die KQL-Aktivität kann in der Regel mit anderen Aktivitäten verwendet werden. Nachdem Sie alle anderen Aktivitäten konfiguriert haben, die für Ihre Pipeline erforderlich sind, wechseln Sie oben im Pipeline-Editor zur Registerkarte Start, und klicken Sie auf die Schaltfläche „Speichern“, um die Pipeline zu speichern. Wählen Sie Ausführen aus, um sie direkt auszuführen, oder Planen, um sie zu planen. Sie können hier auch den Ausführungsverlauf anzeigen oder andere Einstellungen konfigurieren.

Screenshot: Die Registerkarte „Start“ im Pipeline-Editor mit den hervorgehobenen Schaltflächen „Name“, „Speichern“, „Ausführen“ und „Planen“ der Registerkarte.