Udostępnij przez


Używanie działania internetowego do wywoływania interfejsów API REST w potokach

Działanie WebActivity może być używane do wywoływania niestandardowego punktu końcowego REST z potoku usług Azure Data Factory lub Synapse. Można przekazywać zestawy danych i połączone usługi do zużycia i dostępu przez działanie.

Uwaga

Maksymalny obsługiwany rozmiar ładunku odpowiedzi wyjściowej to 4 MB.

Wymagania wstępne

Aby rozpocząć pracę, należy spełnić następujące wymagania wstępne:

Dodawanie działania internetowego do potoku za pomocą interfejsu użytkownika

Aby użyć działania sieci Web w potoku, wykonaj następujące kroki:

Tworzenie działania

  1. Utwórz nowy potok w obszarze roboczym.

  2. Wyszukaj pozycję Sieć Web w okienku Działania potoku i wybierz ją, aby dodać ją do kanwy potoku.

    Zrzut ekranu przedstawiający interfejs użytkownika sieci szkieletowej z wyróżnionym okienkiem Działania i działaniem internetowym.

  3. Wybierz nowe działanie sieci Web na kanwie, jeśli nie zostało jeszcze wybrane.

    Zrzut ekranu przedstawiający kartę Ustawienia ogólne działania sieci Web.

    Uwaga

    Działanie internetowe może być po prostu wyświetlane jako ikona na pasku narzędzi, jak pokazano na poprzedniej ilustracji, jeśli rozdzielczość ekranu nie zezwala na pełne określenie jej nazwy.

Zapoznaj się ze wskazówkami dotyczącymi ustawień ogólnych, aby skonfigurować kartę Ustawienia ogólne.

Ustawienia działania sieci Web

  1. Wybierz kartę Ustawienia , wybierz istniejące połączenie z listy rozwijanej Połączenie lub utwórz nowe połączenie i określ jego szczegóły konfiguracji.

    Zrzut ekranu przedstawiający kartę Ustawienia działania wyszukiwania z wyróżnioną kartą i miejscem wybierania nowego połączenia.

  2. Po wybraniu pozycji + Nowy w celu utworzenia nowego połączenia zostanie wyświetlone okno dialogowe tworzenia połączenia, w którym można podać podstawowy adres URL i poświadczenia do nawiązania połączenia.

    Zrzut ekranu przedstawiający okno dialogowe nowego połączenia dla działania internetowego.

    Uwaga

    Nazwa połączenia może mieć maksymalnie 80 znaków.

Korzystanie z lokalnej lub wirtualnej bramy danych

  1. Podczas tworzenia połączenia możesz teraz użyć lokalnej bramy danych (OPDG) lub bramy danych sieci wirtualnej. Aby uzyskać wskazówki dotyczące tworzenia i konfigurowania lokalnej bramy danych, zapoznaj się z wskazówkami dotyczącymi tworzenia lokalnej bramy danych

  2. Jeśli chcesz użyć bramy sieci wirtualnej, zapoznaj się z instrukcjami tworzenia bramy danych sieci wirtualnej.

  3. Po pomyślnym utworzeniu i skonfigurowaniu bramy, powinna pojawić się w rozwijanej liście Brama danych w oknie dialogowym połączenia.

    Zrzut ekranu przedstawiający okno dialogowe połączenia bramy danych dla działania sieci Web.

  4. Po wybraniu lub utworzeniu połączenia i bramy danych wypełnij pozostałe wymagane pola, dodaj wymagane nagłówki lub ustaw dowolne ustawienia zaawansowane. Działanie internetowe obsługuje metody GET, POST, PUT, DELETE i PATCH.

  5. Po wybraniu lub utworzeniu połączenia ukończ pozostałe wymagane pola, dodaj wymagane nagłówki lub ustaw dowolne ustawienia zaawansowane. Działanie internetowe obsługuje metody GET, POST, PUT, DELETE i PATCH.

Zapisywanie i uruchamianie lub planowanie potoku

Zazwyczaj dane wyjściowe działania internetowego są używane z innymi działaniami, ale po skonfigurowaniu można je uruchamiać bezpośrednio bez innych działań. Jeśli uruchamiasz go w celu wywołania interfejsu API REST, który wykonuje jakąś akcję i nie wymaga żadnych danych wyjściowych z działania, potok może również zawierać tylko działanie internetowe. Aby uruchomić działanie, przejdź do karty Narzędzia główne w górnej części edytora potoku i wybierz przycisk Zapisz, aby zapisać potok. Wybierz pozycję Uruchom , aby uruchomić go bezpośrednio lub Zaplanuj , aby go zaplanować. Historię uruchamiania można również wyświetlić tutaj lub skonfigurować inne ustawienia.

Zrzut ekranu przedstawiający kartę Narzędzia główne w edytorze potoków z wyróżnionymi przyciskami tabulacji Zapisz, Uruchom i Zaplanuj.