Připojení na souborový server SFTP z pracovních postupů v Azure Logic Apps

  • Článek

Platí pro: Azure Logic Apps (Consumption + Standard)

Tento návod ukazuje, jak získat přístup k serveru SSH File Transfer Protocol (SFTP) z pracovního postupu v Azure Logic Apps. SFTP je síťový protokol, který poskytuje přístup k souborům, přenos souborů a správu souborů přes jakýkoli spolehlivý datový proud a používá protokol Secure Shell (SSH ).

V pracovních postupech aplikace logiky Consumption můžete použít spravovaný konektor SFTP-SSH, zatímco v pracovních postupech standardní aplikace logiky můžete použít integrovaný konektor SFTP nebo spravovaný konektor SFTP-SSH. Pomocí těchto operací konektoru můžete vytvářet automatizované pracovní postupy, které se spouští při aktivaci událostmi na serveru SFTP nebo v jiných systémech a spouštět akce pro správu souborů na serveru SFTP. Spravované i integrované konektory používají protokol SSH.

Poznámka:

Spravovaný konektor SFTPje zastaralý, takže se operace tohoto konektoru už nezobrazují v návrháři pracovního postupu.

Váš pracovní postup může například začínat triggerem SFTP, který monitoruje události na serveru SFTP a reaguje na ně. Trigger zpřístupní výstupy následným akcím v pracovním postupu. Váš pracovní postup může spouštět akce SFTP, které získávají, vytvářejí a spravují soubory prostřednictvím účtu serveru SFTP. Následující seznam obsahuje další příklady úkolů:

  • Sledujte, kdy se přidají nebo změní soubory.
  • Získejte, vytvořte, zkopírujte, přejmenujte, aktualizujte, vypisujte a odstraňujte soubory.
  • Vytvořte složky.
  • Získejte obsah a metadata souborů.
  • Extrahujte archivy do složek.

Následující kroky používají Web Azure Portal, ale s příslušným rozšířením Azure Logic Apps můžete k vytvoření a úpravě pracovních postupů aplikace logiky použít také následující nástroje:

Připojení otechnické referenční informace

Konektor SFTP má různé verze založené na typu aplikace logiky a hostitelském prostředí.

Typ aplikace logiky (plán) Prostředí verze Připojení oru
Využití Azure Logic Apps s více tenanty Spravovaný konektor, který se zobrazí v návrháři pod popiskem Standard . Další informace najdete v následující dokumentaci:

- Referenční informace ke spravovanému konektoru SFTP-SSH
- Spravované konektory v Azure Logic Apps
Využití Prostředí integrační služby (ISE) Spravovaný konektor, který se zobrazí v návrháři pod standardním popiskem, a verzi ISE, která se zobrazí v návrháři s popiskem ISE a má jiné limity zpráv než spravovaný konektor. Další informace najdete v následující dokumentaci:

- Referenční informace ke spravovanému konektoru SFTP-SSH
- Omezení zpráv ISE
- Spravované konektory v Azure Logic Apps
Standard Azure Logic Apps a App Service Environment v3 s jedním tenantem (pouze plány Windows) Spravovaný konektor, který se zobrazí v galerii konektorů v části Sdílené modul runtime>a integrovaný konektor, který se zobrazí v galerii konektorů v části Modul runtime>v aplikaci a je založený na poskytovateli služeb. Integrovaný konektor se může přímo připojit k serveru SFTP a přistupovat k virtuálním sítím Azure pomocí připojovací řetězec bez místní brány dat. Další informace najdete v následující dokumentaci:

- Referenční informace ke spravovanému konektoru SFTP-SSH
- Referenční informace k integrovanému konektoru SFTP

- Spravované konektory v Azure Logic Apps
- Integrované konektory v Azure Logic Apps

Obecná omezení

  • Před použitím spravovaného konektoru SFTP-SSH si projděte známé problémy a omezení v referenčních informacích ke spravovanému konektoru SFTP-SSH.

  • Než začnete používat integrovaný konektor SFTP, projděte si známé problémy a omezení v referenčních informacích k integrovanému konektoru SFTP.

Známé problémy

Ve výchozím nastavení triggery, které vracejí pole, mají již povolené nastavení Rozdělit na . Když je toto nastavení povolené, trigger automaticky rozdělí pole interně vytvořením samostatné instance pracovního postupu pro zpracování každé položky pole. Všechny instance pracovního postupu běží paralelně, aby se položky pole zpracovávaly současně.

Pokud je ale povolené nastavení Rozdělit na , aktivují spravované konektory výstupy pro všechny položky pole jako seznamy. Všechny následné akce, které odkazují na tyto výstupy, musí nejprve zpracovat tyto výstupy jako seznamy. Pokud chcete zpracovat každou položku pole jednotlivě, můžete přidat další akce. Pokud chcete například iterovat tyto položky pole, můžete použít smyčku For each . U triggerů, které vracejí pouze metadata nebo vlastnosti, použijte nejprve akci, která získá metadata položky pole, a pak pomocí akce získejte obsah položek.

Tento přístup musíte použít pouze pro triggery spravovaných konektorů, ne pro integrované triggery konektorů, které vracejí výstupy pro jednu položku pole v okamžiku, kdy je povoleno nastavení Rozdělit na .

Předpokládejme například, že máte trigger spravovaného konektoru s názvem Při přidání nebo změně souboru (pouze vlastnosti), který vrací metadata nebo vlastnosti pro nové nebo aktualizované soubory jako pole. Pokud chcete získat metadata pro každý soubor samostatně, můžete použít smyčku For each iterates prostřednictvím pole. V této smyčce použijte následující akce spravovaného konektoru v zadaném pořadí:

  1. Získejte metadata souborů, abyste získali metadata jednotlivých souborů.

  2. Získejte akci obsahu souboru, abyste získali obsah jednotlivých souborů.

Chunking

Další informace o tom, jak spravovaný konektor SFTP-SSH dokáže zpracovávat velké soubory překračující výchozí limity velikosti, najdete v referenčních informacích ke spravovaným konektorům SFTP-SSH – bloky dat.

Předpoklady

  • Účet a předplatné Azure. Pokud nemáte předplatné Azure, zaregistrujte si bezplatný účet Azure.

  • Připojení a ověřovacích informací pro přístup k serveru SFTP, jako je adresa serveru, přihlašovací údaje účtu, přístup k privátnímu klíči SSH a heslo privátního klíče SSH. Další informace najdete v referenčních informacích ke spravovanému konektoru SFTP-SSH – ověřování a oprávnění.

    Důležité

    Když vytvoříte připojení a zadáte privátní klíč SSH do vlastnosti privátního klíče SSH, nezapomeňte pro tuto vlastnost zadat úplnou a správnou hodnotu. V opačném případě neplatný klíč způsobí selhání připojení.

  • Pracovní postup aplikace logiky, ve kterém chcete získat přístup k vašemu účtu SFTP. Pokud chcete začít s triggerem SFTP-SSH, musíte začít s prázdným pracovním postupem. Pokud chcete použít akci SFTP-SSH, spusťte pracovní postup s jinou aktivační událostí, například triggerem opakování .

Přidání triggeru SFTP

  1. Na webu Azure Portal otevřete aplikaci logiky Consumption s prázdným pracovním postupem v návrháři.

  2. V návrháři přidejte požadovaný trigger SFTP-SSH podle těchto obecných kroků.

  3. Pokud se zobrazí výzva, zadejte potřebné informace o připojení. Až budete hotovi, vyberte Vytvořit.

  4. Po zobrazení informačního pole aktivační události zadejte potřebné podrobnosti pro vybraný trigger. Další informace najdete v referenčních informacích ke triggerům spravovaných konektorů SFTP-SSH.

  5. Až budete hotovi, uložte pracovní postup. Na panelu nástrojů návrháře vyberte Uložit.

Když pracovní postup uložíte, tento krok automaticky publikuje aktualizace do nasazené aplikace logiky, která je aktivní v Azure. Pouze s triggerem váš pracovní postup pouze kontroluje server FTP na základě zadaného plánu. Musíte přidat akci, která reaguje na trigger a provede něco s výstupy triggeru.

Například trigger s názvem Při přidání nebo změně souboru spustí pracovní postup při přidání nebo změně souboru na serveru SFTP. Jako další akci můžete přidat podmínku, která zkontroluje, jestli obsah souboru splňuje zadaná kritéria. Pokud obsah splňuje podmínku, použijte akci s názvem Získat obsah souboru k získání obsahu souboru a pak použijte jinou akci k umístění obsahu daného souboru do jiné složky na serveru SFTP.

Přidání akce SFTP

Než budete moct použít akci SFTP, váš pracovní postup už musí začínat triggerem, což může být jakýkoliv druh, který zvolíte. Můžete například použít obecnou integrovanou aktivační událost Opakování ke spuštění pracovního postupu podle konkrétního plánu.

  1. Na webu Azure Portal otevřete aplikaci logiky Consumption s pracovním postupem v návrháři.

  2. V návrháři postupujte podle těchto obecných kroků a přidejte požadovanou akci SFTP-SSH.

  3. Pokud se zobrazí výzva, zadejte potřebné informace o připojení. Až budete hotovi, vyberte Vytvořit.

  4. Jakmile se zobrazí pole s informacemi o akci, zadejte potřebné podrobnosti pro vybranou akci. Další informace najdete v referenčních informacích k akcím spravovaných konektorů SFTP-SSH.

  5. Až budete hotovi, uložte pracovní postup. Na panelu nástrojů návrháře vyberte Uložit.

Například akce s názvem Získat obsah souboru pomocí cesty získá obsah ze souboru na serveru SFTP zadáním cesty k souboru. Aktivační událost z předchozího příkladu a podmínku, kterou musí obsah souboru splňovat, můžete použít. Pokud je podmínka pravdivá, může následná akce získat obsah.

Řešení problému

Další informace najdete v následující dokumentaci:

Další kroky