Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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:
- Sie benötigen Zugriff auf einen Microsoft Fabric-Mandanten mit einer bereitgestellten Kapazität. Sie können Fabric mit einer kostenlosen Testversion testen.
- Ein Fabric-Arbeitsbereich , der dieser Kapazität zugewiesen ist.
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
Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.
Suchen Sie im Bereich Aktivitäten der Pipeline nach „KQL“ und wählen Sie es aus, um es auf dem Pipeline-Canvas hinzuzufügen.
Hinweis
Um die KQL-Aktivität wie im folgenden Screenshot hervorgehoben anzuzeigen, müssen Sie möglicherweise das Menü erweitern und herunterscrollen.
Wählen Sie die neue KQL-Aktivität auf dem Pipeline-Editor-Canvas aus, wenn sie noch nicht ausgewählt ist.
Informationen finden Sie in der Anleitung zu den Allgemeinen Einstellungen, um die Registerkarte Allgemein zu konfigurieren.
KQL-Aktivitätseinstellungen
Wählen Sie die Registerkarte Einstellungen und dann Ihre KQL-Datenbank-Verbindung in 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.
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.
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, können Sie die Pipeline speichern und ausführen oder planen.
Wechseln Sie oben im Pipeline-Editor zur Registerkarte " Start ", und wählen Sie die Schaltfläche "Speichern" aus, um Ihre Pipeline zu speichern. Wählen Sie "Ausführen" aus, um sie direkt auszuführen, oder planen Sie die Ausführung zu bestimmten Zeiten oder Intervallen. Weitere Informationen zu Pipelineausführungen finden Sie unter: Pipelineausführungen planen.
Nach dem Ausführen können Sie die Ausführung der Pipeline überwachen und den Ausführungsverlauf über die Registerkarte Ausgabe unterhalb des Zeichenbereichs anzeigen.
Bekannte Einschränkungen
- Einschränkung der arbeitsbereichübergreifenden Bereitstellung: Wenn eine Pipeline, die eine KQL-Aktivität enthält, in Arbeitsbereichen mithilfe von Bereitstellungspipelines bereitgestellt wird, werden arbeitsbereichspezifische verknüpfte Diensteigenschaften nicht neu zugeordnet und verweisen weiterhin auf den Quellarbeitsbereich. Dies kann dazu führen, dass Pipelineausführungen im Zielarbeitsbereich mit UserErrorKustoReadFailed / EntityNotFoundException fehlschlagen.
Die Problemumgehung besteht darin, Arbeitsbereichsvariablen (Variable Library) für alle arbeitsbereichspezifischen Verbindungseigenschaften zu verwenden und über endpointVariableLibrary, artifactIdVariableLibrary und workspaceIdVariableLibrary darauf zu verweisen.