Połączenie do serwera plików SFTP z przepływów pracy w usłudze Azure Logic Apps

  • Artykuł

Dotyczy: Azure Logic Apps (Zużycie + Standardowa)

W tym przewodniku z instrukcjami pokazano, jak uzyskać dostęp do serwera protokołu SSH File Transfer Protocol (SFTP) z przepływu pracy w usłudze Azure Logic Apps. SFTP to protokół sieciowy, który zapewnia dostęp do plików, transfer plików i zarządzanie plikami za pośrednictwem dowolnego niezawodnego strumienia danych i używa protokołu Secure Shell (SSH).

W przepływach pracy aplikacji logiki Zużycie można użyć łącznika zarządzanego SFTP-SSH, podczas gdy w przepływach pracy aplikacji logiki w warstwie Standardowa można użyć wbudowanego łącznika SFTP lub łącznika zarządzanego SFTP-SSH. Za pomocą tych operacji łącznika można tworzyć zautomatyzowane przepływy pracy uruchamiane po wyzwoleniu przez zdarzenia na serwerze SFTP lub w innych systemach i uruchamiać akcje do zarządzania plikami na serwerze SFTP. Zarówno zarządzane, jak i wbudowane łączniki używają protokołu SSH.

Uwaga

Łącznik zarządzany SFTPzostał przestarzały, więc operacje tego łącznika nie są już wyświetlane w projektancie przepływu pracy.

Na przykład przepływ pracy może rozpoczynać się od wyzwalacza SFTP, który monitoruje zdarzenia na serwerze SFTP i reaguje na nie. Wyzwalacz udostępnia dane wyjściowe kolejnym akcjom w przepływie pracy. Przepływ pracy może uruchamiać akcje SFTP, które pobierają, tworzą i zarządzają plikami za pośrednictwem konta serwera SFTP. Poniższa lista zawiera więcej przykładowych zadań:

  • Monitoruj, kiedy pliki są dodawane lub zmieniane.
  • Pobieranie, tworzenie, kopiowanie, zmienianie nazwy, aktualizowanie, wyświetlanie listy i usuwanie plików.
  • Utwórz foldery.
  • Pobieranie zawartości pliku i metadanych.
  • Wyodrębnianie archiwów do folderów.

Poniższe kroki korzystają z witryny Azure Portal, ale przy użyciu odpowiedniego rozszerzenia usługi Azure Logic Apps można również użyć następujących narzędzi do tworzenia i edytowania przepływów pracy aplikacji logiki:

dokumentacja techniczna Połączenie or

Łącznik SFTP ma różne wersje na podstawie typu aplikacji logiki i środowiska hosta.

Typ aplikacji logiki (plan) Środowisko wersja Połączenie or
Zużycie Wielodostępna usługa Azure Logic Apps Łącznik zarządzany, który jest wyświetlany w projektancie pod etykietą Standardowa . Aby uzyskać więcej informacji, zapoznaj się z następującą dokumentacją:

- Dokumentacja łącznika zarządzanego SFTP-SSH
- Łączniki zarządzane w usłudze Azure Logic Apps
Zużycie Środowisko usługi integracji (ISE) Łącznik zarządzany, który jest wyświetlany w projektancie pod etykietą Standardowa , oraz w wersji ISE, która jest wyświetlana w projektancie z etykietą ISE i ma inne limity komunikatów niż zarządzany łącznik. Aby uzyskać więcej informacji, zapoznaj się z następującą dokumentacją:

- Dokumentacja łącznika zarządzanego SFTP-SSH
- Limity komunikatów ISE
- Łączniki zarządzane w usłudze Azure Logic Apps
Standardowy Usługa Azure Logic Apps i środowisko App Service Environment w wersji 3 z jedną dzierżawą (tylko plany systemu Windows) Łącznik zarządzany wyświetlany w galerii łączników w obszarze Udostępnione środowisko uruchomieniowe>i wbudowany łącznik, który jest wyświetlany w galerii łączników w obszarze Środowisko uruchomieniowe>w aplikacji i jest oparty na dostawcy usług. Wbudowany łącznik może łączyć się bezpośrednio z serwerem SFTP i uzyskiwać dostęp do sieci wirtualnych platformy Azure przy użyciu parametry połączenia bez lokalnej bramy danych. Aby uzyskać więcej informacji, zapoznaj się z następującą dokumentacją:

- Dokumentacja łącznika zarządzanego SFTP-SSH
- Dokumentacja wbudowanego łącznika SFTP

- Łączniki zarządzane w usłudze Azure Logic Apps
- Wbudowane łączniki w usłudze Azure Logic Apps

Ogólne ograniczenia

  • Przed użyciem łącznika zarządzanego SFTP-SSH zapoznaj się ze znanymi problemami i ograniczeniami w dokumentacji łącznika zarządzanego SFTP-SSH.

  • Przed użyciem wbudowanego łącznika SFTP zapoznaj się ze znanymi problemami i ograniczeniami w dokumentacji wbudowanego łącznika SFTP.

Znane problemy

Domyślnie wyzwalacze, które zwracają tablicę, mają już włączone ustawienie Split On . Po włączeniu tego ustawienia wyzwalacz automatycznie debatuje tablicę przez wewnętrzne utworzenie oddzielnego wystąpienia przepływu pracy w celu przetworzenia każdego elementu tablicy. Wszystkie wystąpienia przepływu pracy działają równolegle, aby elementy tablicy zostały przetworzone w tym samym czasie.

Jednak po włączeniu ustawienia Split On (Podział wł. ) wyzwalacz zarządzany łącznik zwraca dane wyjściowe dla wszystkich elementów tablicy jako list. Wszelkie kolejne akcje odwołujące się do tych danych wyjściowych muszą najpierw obsługiwać te dane wyjściowe jako listy. Aby obsłużyć każdy element tablicy osobno, możesz dodać dodatkowe akcje. Na przykład w celu iterowania tych elementów tablicy można użyć pętli For each . W przypadku wyzwalaczy, które zwracają tylko metadane lub właściwości, użyj akcji, która najpierw pobiera metadane elementu tablicy, a następnie użyj akcji w celu pobrania zawartości elementów.

Należy zastosować to podejście tylko w przypadku wyzwalaczy łącznika zarządzanego , a nie wbudowanych wyzwalaczy łącznika, które zwracają dane wyjściowe dla jednego elementu tablicy w danym momencie, gdy ustawienie Split On jest włączone.

Załóżmy na przykład, że masz wyzwalacz łącznika zarządzanego o nazwie Po dodaniu lub zmodyfikowaniu pliku (tylko właściwości), który zwraca metadane lub właściwości nowych lub zaktualizowanych plików jako tablic. Aby pobrać metadane oddzielnie dla każdego pliku, możesz użyć pętli For each iterates through the array (Dla każdej pętli), która iteruje przez tablicę. W tej pętli użyj następujących akcji łącznika zarządzanego w określonej kolejności:

  1. Pobierz metadane pliku, aby pobrać metadane każdego pliku.

  2. Pobierz akcję zawartości pliku, aby pobrać zawartość każdego pliku.

Segmentu

Aby uzyskać więcej informacji o tym, jak łącznik zarządzany SFTP-SSH może obsługiwać duże pliki przekraczające domyślne limity rozmiaru, zobacz sfTP-SSH managed connector reference - Chunking (Dokumentacja łącznika zarządzanego SFTP-SSH — fragmentowanie).

Wymagania wstępne

Dodawanie wyzwalacza SFTP

  1. W witrynie Azure Portal otwórz aplikację logiki Zużycie z pustym przepływem pracy w projektancie.

  2. W projektancie wykonaj następujące ogólne kroki, aby dodać odpowiedni wyzwalacz SFTP-SSH.

  3. Jeśli zostanie wyświetlony monit, podaj niezbędne informacje o połączeniu. Po zakończeniu wybierz Utwórz.

  4. Po pojawieniu się pola informacji o wyzwalaczu podaj niezbędne szczegóły wybranego wyzwalacza. Aby uzyskać więcej informacji, zobacz SfTP-SSH managed connector triggers reference (Dokumentacja wyzwalaczy zarządzanych łącznika SFTP-SSH).

  5. Gdy wszystko będzie gotowe, zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Po zapisaniu przepływu pracy ten krok automatycznie publikuje aktualizacje wdrożonej aplikacji logiki, która jest aktywna na platformie Azure. W przypadku tylko wyzwalacza przepływ pracy sprawdza tylko serwer FTP na podstawie określonego harmonogramu. Musisz dodać akcję odpowiadającą wyzwalaczowi i wykonać coś z danymi wyjściowymi wyzwalacza.

Na przykład wyzwalacz o nazwie Po dodaniu lub zmodyfikowaniu pliku uruchamia przepływ pracy po dodaniu lub zmianie pliku na serwerze SFTP. W ramach kolejnej akcji można dodać warunek sprawdzający, czy zawartość pliku spełnia określone kryteria. Jeśli zawartość spełnia warunek, użyj akcji o nazwie Pobierz zawartość pliku, aby pobrać zawartość pliku, a następnie użyj innej akcji, aby umieścić tę zawartość pliku w innym folderze na serwerze SFTP.

Dodawanie akcji SFTP

Aby można było użyć akcji SFTP, przepływ pracy musi już zaczynać się od wyzwalacza, który może być dowolnym wybranym rodzajem. Na przykład możesz użyć ogólnego wbudowanego wyzwalacza Cykl , aby uruchomić przepływ pracy zgodnie z określonym harmonogramem.

  1. W witrynie Azure Portal otwórz aplikację logiki Zużycie z przepływem pracy w projektancie.

  2. W projektancie wykonaj następujące ogólne kroki, aby dodać odpowiednią akcję SFTP-SSH.

  3. Jeśli zostanie wyświetlony monit, podaj niezbędne informacje o połączeniu. Po zakończeniu wybierz Utwórz.

  4. Po pojawieniu się pola informacji o akcji podaj niezbędne szczegóły wybranej akcji. Aby uzyskać więcej informacji, zobacz Dokumentację akcji łącznika zarządzanego SFTP-SSH.

  5. Gdy wszystko będzie gotowe, zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Na przykład akcja o nazwie Pobierz zawartość pliku przy użyciu ścieżki pobiera zawartość z pliku na serwerze SFTP, określając ścieżkę pliku. Możesz użyć wyzwalacza z poprzedniego przykładu i warunku, który musi spełniać zawartość pliku. Jeśli warunek ma wartość true, kolejna akcja może pobrać zawartość.

Rozwiązywanie problemów

Aby uzyskać więcej informacji, zobacz następującą dokumentację:

Następne kroki