Freigeben über


Verwenden der Webaktivität zum Aufrufen von REST-APIs in Pipelines

Die Webaktivität kann verwendet werden, um einen benutzerdefinierten REST-Endpunkt aus einer Azure Data Factory- oder Synapse-Pipeline aufzurufen. Sie können Datasets und verknüpfte Dienste zur Verwendung und für den Zugriff durch die Aktivität übergeben.

Hinweis

Die maximal unterstützte Payloadgröße für die Ausgabe von Antworten beträgt 4 MB.

Voraussetzungen

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

Hinzufügen einer Webaktivität zu einer Pipeline über die Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um eine Webaktivitä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 „Web“, und fügen Sie diese Aktivität auf dem Pipelinecanvas hinzu.

    Screenshot der Fabric-Benutzeroberfläche mit hervorgehobenem Bereich

  3. Wählen Sie die neue Webaktivität im Canvas aus, wenn sie noch nicht ausgewählt ist.

    Screenshot der Registerkarte

    Hinweis

    Die Webaktivität wird möglicherweise einfach als Symbol auf der Symbolleiste angezeigt, wie in der vorherigen Abbildung dargestellt, wenn die Bildschirmauflösung nicht zulässt, dass der Name vollständig geschrieben werden kann.

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

Einstellungen der Webaktivität

  1. Wählen Sie die Registerkarte "Einstellungen " aus, wählen Sie eine vorhandene Verbindung aus der Dropdownliste "Verbindung " aus, oder erstellen Sie eine neue Verbindung, und geben Sie die Konfigurationsdetails an.

    Screenshot: Hervorhebung der Registerkarte „Einstellungen für Lookup-Aktivitäten“ und Festlegen einer neuen Verbindung.

  2. Wenn Sie + Neue auswählen, um eine neue Verbindung zu erstellen, wird das Dialogfeld zum Erstellen der Verbindung angezeigt, in dem Sie die Basis-URL und Anmeldeinformationen für die Verbindung angeben können.

    Screenshot des Dialogfelds

    Hinweis

    Der Name der Verbindung kann maximal 80 Zeichen lang sein.

  3. Nachdem Sie Ihre Verbindung ausgewählt oder erstellt haben, schließen Sie die verbleibenden erforderlichen Felder ab, fügen Sie alle erforderlichen Kopfzeilen hinzu, oder legen Sie erweiterte Einstellungen fest. Die Webaktivität unterstützt GET-, POST-, PUT-, DELETE- und PATCH-Methoden.

Speichern und Ausführen oder Planen der Pipeline

In der Regel verwenden Sie die Ausgabe der Webaktivität mit anderen Aktivitäten, aber nach der Konfiguration kann sie auch ohne andere Aktivitäten direkt ausgeführt werden. Wenn Sie sie ausführen, um eine REST-API aufzurufen, die eine Aktion ausführt und keine Ausgabe der Aktivität erfordert, enthält Ihre Pipeline möglicherweise auch nur die Webaktivität. Um die Aktivität hier auszuführen, wechseln Sie oben im Pipeline-Editor zur Registerkarte Home, 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, 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.