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:

• Ein Mandantenkonto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
• Ein Arbeitsbereich wurde erstellt.

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.

   

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

   

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 einen Datenspeichertyp aus. Sie können eine in Ihrem Fabric-Arbeitsbereich erstellte KQL-Datenbank verwenden oder eine Verbindung mit einer externen Datenbank mit Azure Data Explorer herstellen, indem Sie einen Cluster-URI, eine Datenbank und Anmeldeinformationen bereitstellen.

2. Wählen Sie als Nächstes die Verbindung zu Ihrer KQL-Datenbank aus. 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.

3. 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.

   

4. 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.

Zugehöriger Inhalt

• Überwachen von Pipelineausführungen