Verwenden der Azure Batch-Aktivität zum Ausführen eines Befehls in einer Azure Batch-Instanz

Die Azure Batch-Aktivität in Fabric Data Factory erlaubt es Ihnen, einen Befehl gegen eine Azure Batch-Instanz auszuführen. Wenn Sie von Azure Data Factory oder Azure Synapse zu Fabric Data Factory migrieren, heißt diese Aktivität benutzerdefinierte Aktivität.

Voraussetzungen

Um zu beginnen, müssen Sie die folgenden Voraussetzungen erfüllen:

Hinzufügen einer Azure Batch-Aktivität zu einer Pipeline mit Benutzeroberfläche

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

Erstellen der Aktivität

  1. Erstellen Sie eine neue Pipeline in Ihrem Arbeitsbereich.

  2. Suchen Sie im Bereichs "Pipeline Aktivitäten" nach Azure Batch, und wählen Sie es aus, um es zur Pipeline-Leinwand hinzuzufügen.

    Anmerkung

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

    Screenshot der Fabric-Benutzeroberfläche mit hervorgehobenem Aktivitätenbereich und Azure Batch-Aktivität.

  3. Wählen Sie die neue Azure Batch-Aktivität im Pipeline-Editor-Canvas aus, wenn sie noch nicht ausgewählt ist.

    Screenshot mit der Registerkarte

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

Azure Batch-Aktivitätseinstellungen

Wählen Sie die Registerkarte Einstellungen aus, und Sie können dann eine vorhandene oder eine neue Azure Batch-Verbindungauswählen, einen Befehl bereitstellen und eine Ressourcenverbindung mit einem Speicherkonto. Sie können auch einen bestimmten Ordnerpfad innerhalb des Speicherkontos sowie eine Aufbewahrungszeit in Tagen angeben, um die dort gespeicherten Daten aufzubewahren, und eigene erweiterte Eigenschaften hinzufügen.

Die Azure Batch-Aktivität unterstützt WI-, SPN- und OAuth-Verbindungstypen.

Screenshot mit der Registerkarte

Verwendung von Fabric workspace identity in der Azure Batch-Aktivität

  1. Erstellen Sie die Arbeitsbereichsidentität

    Du musst die Workspace-Identität in deinem Workspace aktivieren (das kann einen Moment zum Laden dauern). Erstellen Sie eine Arbeitsbereichsidentität in Ihrem Fabric-Arbeitsbereich. Beachte, dass die Workspace-Identität im selben Workspace wie deine Pipeline erstellt werden sollte.

    Schau dir die Dokumentation zu Workspace Identity an.

  2. Aktivieren von Einstellungen auf Mandantenebene

    Aktivieren Sie die folgende Mandanteneinstellung (standardmäßig deaktiviert): Service-Prinzipale können öffentliche Fabric-APIs aufrufen.

    Sie können diese Einstellung im Fabric-Verwaltungsportal aktivieren. Weitere Informationen zu dieser Einstellung finden Sie im Artikel zum Aktivieren der Dienstprinzipalauthentifizierung für Administrator-APIs.

  3. Workspace-Berechtigungen für die Workspace-Identität gewähren

    Öffnen Sie den Arbeitsbereich, wählen Sie Zugriff verwalten und weisen Sie der Arbeitsbereichsidentität Berechtigungen zu. Der Mitwirkendezugriff ist für die meisten Szenarien ausreichend.

    Sehen Sie sich die Dokumentation zu Benutzern Zugriff auf Arbeitsbereiche gewähren an.

Speichern und Ausführen oder Planen der Pipeline

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.

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

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 Probleme

  • Die Workspace-Identity-Option in den Verbindungseinstellungen taucht in manchen Fällen nicht auf. An einem Fix für diesen Fehler wird derzeit gearbeitet.
  • Die Verwendung des Dienstprinzipals zum Ausführen eines Notizbuchs, das semantischen Link-Code enthält, weist funktionale Einschränkungen auf und unterstützt nur eine Teilmenge von semantischen Link-Features. Ausführliche Informationen finden Sie in den unterstützten Funktionen für semantische Verknüpfungen . Um andere Funktionen zu verwenden, empfiehlt es sich, die semantische Verknüpfung mit einem Dienstprinzipal manuell zu authentifizieren.
  • Manche Kunden sehen das Dropdown-Menü für die Workspace-Identität möglicherweise nicht, oder es wird zwar angezeigt, sie können jedoch keine Verbindung erstellen. Dieses Verhalten ist auf ein bekanntes Problem in einer unserer zugrunde liegenden Plattformkomponenten zurückzuführen. Die Korrektur wird derzeit bearbeitet.