Megosztás a következőn keresztül:

Csatlakozás SFTP-fájlkiszolgálóhoz az Azure Logic Apps munkafolyamataiból

  • Cikk

A következőkre vonatkozik: Azure Logic Apps (Használat + Standard)

Ez az útmutató bemutatja, hogyan férhet hozzá az SSH-fájlátviteli protokoll (SFTP) kiszolgálóhoz az Azure Logic Apps munkafolyamatából. Az SFTP egy hálózati protokoll, amely fájlhozzáférést, fájlátvitelt és fájlkezelést biztosít bármely megbízható adatfolyamon keresztül, és a Secure Shell (SSH) protokollt használja.

A Használat logikai alkalmazás munkafolyamataiban használhatja az SFTP-SSH által felügyelt összekötőt, míg a Standard logikai alkalmazás munkafolyamataiban használhatja a beépített SFTP-összekötőt vagy az SFTP-SSH által felügyelt összekötőt. Ezekkel az összekötőműveletekkel automatizált munkafolyamatokat hozhat létre, amelyek akkor futnak, amikor az SFTP-kiszolgálón vagy más rendszerekben események aktiválódnak, és műveleteket futtathat az SFTP-kiszolgálón lévő fájlok kezeléséhez. A felügyelt és a beépített összekötők is az SSH protokollt használják.

Feljegyzés

Az SFTPáltal felügyelt összekötő elavult, így az összekötő műveletei már nem jelennek meg a munkafolyamat-tervezőben.

A munkafolyamat például egy SFTP-eseményindítóval kezdődhet, amely figyeli és válaszol az SFTP-kiszolgálón lévő eseményekre. Az eseményindító elérhetővé teszi a kimeneteket a munkafolyamat későbbi műveletei számára. A munkafolyamat SFTP-műveleteket futtathat, amelyek fájlokat kapnak, hoznak létre és kezelnek az SFTP-kiszolgálófiókon keresztül. Az alábbi lista további példafeladatokat tartalmaz:

  • A fájlok hozzáadásának vagy módosításának figyelése.
  • Fájlok lekérése, létrehozása, másolása, átnevezése, frissítése, listázása és törlése.
  • Mappák létrehozása.
  • Fájltartalom és metaadatok lekérése.
  • Archívumok kinyerve mappákba.

Az alábbi lépések az Azure Portalt használják, de a megfelelő Azure Logic Apps-bővítménysel a következő eszközökkel is létrehozhat és szerkeszthet logikaialkalmazás-munkafolyamatokat:

Összekötők műszaki referenciája

Az SFTP-összekötő különböző verziókkal rendelkezik, a logikai alkalmazás típusa és a gazdagépkörnyezet alapján.

Logikai alkalmazás típusa (csomag) Környezet Összekötő verziója
Fogyasztás Több-bérlős Azure Logic Apps Felügyelt összekötő, amely a tervezőben a Standard címke alatt jelenik meg. További információkért tekintse át a következő dokumentációt:

- SFTP-SSH felügyelt összekötő referenciája
- Felügyelt összekötők az Azure Logic Appsben
Fogyasztás Integrációs szolgáltatási környezet (ISE) Felügyelt összekötő, amely a tervezőben a Standard címke alatt jelenik meg, és az ISE-verzió, amely az ISE címkével jelenik meg a tervezőben, és más üzenetkorlátokkal rendelkezik, mint a felügyelt összekötő. További információkért tekintse át a következő dokumentációt:

- SFTP-SSH felügyelt összekötő referenciája
- ISE-üzenetkorlátok
- Felügyelt összekötők az Azure Logic Appsben
Standard Egybérlős Azure Logic Apps és App Service Environment v3 (csak Windows-csomagok esetén) Felügyelt összekötő, amely az összekötő katalógusában a Megosztott futtatókörnyezet>alatt jelenik meg, valamint a beépített összekötő, amely az alkalmazáson belüli futtatókörnyezetben> található összekötőgyűjteményben jelenik meg, és szolgáltatóalapú. A beépített összekötő közvetlenül csatlakozhat egy SFTP-kiszolgálóhoz, és helyszíni adatátjáró nélküli kapcsolati sztring használatával érheti el az Azure-beli virtuális hálózatokat. További információkért tekintse át a következő dokumentációt:

- SFTP-SSH felügyelt összekötő referenciája
- SFTP beépített összekötő referenciája

- Felügyelt összekötők az Azure Logic Appsben
- Beépített összekötők az Azure Logic Appsben

Általános korlátozások

Ismert problémák

Alapértelmezés szerint a tömböt visszaadó eseményindítóknál már engedélyezve van a felosztási beállítás. Ha ez a beállítás engedélyezve van, az eseményindító automatikusan megszakítja a tömböt úgy, hogy belsőleg létrehoz egy külön munkafolyamat-példányt az egyes tömbelemek feldolgozásához. Az összes munkafolyamat-példány párhuzamosan fut, így a tömbelemek feldolgozása egyszerre történik.

Ha azonban a Split On beállítás engedélyezve van, a felügyelt összekötő-eseményindítók az összes tömbelem kimenetét visszaadják listákként. Az ezekre a kimenetekre hivatkozó további műveleteknek először listákként kell kezelniük ezeket a kimeneteket. Az egyes tömbelemek külön-külön történő kezeléséhez további műveleteket is hozzáadhat. Ha például át szeretné haladni ezeket a tömbelemeket, minden ciklushoz használhat egy-egy elemet. Olyan eseményindítók esetén, amelyek csak metaadatokat vagy tulajdonságokat adnak vissza, használjon olyan műveletet, amely először lekéri a tömbelem metaadatait, majd egy művelet használatával lekéri az elemek tartalmát.

Ezt a módszert csak felügyelt összekötő-eseményindítókra kell alkalmaznia, nem pedig olyan beépített összekötő-eseményindítókra, amelyek egy tömbelem kimeneteit adnak vissza a Split On beállítás engedélyezésekor.

Tegyük fel például, hogy a felügyelt összekötő eseményindítója neve : Amikor hozzáad vagy módosít egy fájlt (csak tulajdonságok), amely tömbökként adja vissza az új vagy frissített fájlok metaadatait vagy tulajdonságait. Ha az egyes fájlok metaadatait külön szeretné lekérni, használhatja a tömbön át iterálható minden ciklushoz. Ebben a ciklusban a következő felügyelt összekötő-műveleteket használja a megadott sorrendben:

  1. Kérje le a fájl metaadatait az egyes fájlok metaadatainak lekéréséhez.

  2. Fájltartalom-művelet lekérése az egyes fájlok tartalmának lekéréséhez.

Adattömb

További információ arról, hogy az SFTP-SSH felügyelt összekötő hogyan képes kezelni az alapértelmezett méretkorlátot meghaladó nagyméretű fájlokat, lásd : SFTP-SSH felügyelt összekötő – Adattömbkezelés.

Előfeltételek

  • Azure-fiók és -előfizetés. Ha nem rendelkezik Azure-előfizetéssel, regisztráljon egy ingyenes Azure-fiókra.

  • Kapcsolati és hitelesítési információk az SFTP-kiszolgáló eléréséhez, például a kiszolgáló címe, a fiók hitelesítő adatai, az SSH titkos kulcshoz való hozzáférés és az SSH titkos kulcs jelszava. További információ: SFTP-SSH felügyelt összekötő – Hitelesítés és engedélyek.

    Fontos

    Amikor létrehozza a kapcsolatot, és beírja az SSH titkos kulcsát az SSH titkos kulcs tulajdonságába, mindenképpen kövesse a tulajdonság teljes és helyes értékének megadásához szükséges lépéseket. Ellenkező esetben egy érvénytelen kulcs miatt a kapcsolat meghiúsul.

  • A logikai alkalmazás munkafolyamata, ahol hozzá szeretne férni az SFTP-fiókhoz. Az SFTP-SSH-eseményindítóval való kezdéshez egy üres munkafolyamatot kell használnia. SFTP-SSH-művelet használatához indítsa el a munkafolyamatot egy másik eseményindítóval, például az Ismétlődés eseményindítóval.

SFTP-eseményindító hozzáadása

  1. Az Azure Portalon nyissa meg a Consumption logikai alkalmazást üres munkafolyamattal a tervezőben.

  2. A tervezőben kövesse az alábbi általános lépéseket a kívánt SFTP-SSH-eseményindító hozzáadásához.

  3. Ha a rendszer kéri, adja meg a szükséges kapcsolati adatokat. Amikor elkészült, válassza a Létrehozás lehetőséget.

  4. Az eseményindító információs mezőjének megjelenése után adja meg a kiválasztott eseményindítóhoz szükséges adatokat. További információ: SFTP-SSH felügyelt összekötő eseményindítók referenciája.

  5. Ha végzett, mentse a munkafolyamatot. A tervező eszköztárán válassza a Mentés lehetőséget.

A munkafolyamat mentésekor ez a lépés automatikusan közzéteszi a frissítéseket az Azure-ban élő üzembe helyezett logikai alkalmazásban. A munkafolyamat csak egy eseményindítóval ellenőrzi az FTP-kiszolgálót a megadott ütemezés szerint. Olyan műveletet kell hozzáadnia, amely reagál az eseményindítóra, és végrehajt valamit az eseményindító kimeneteivel.

Például a Fájl hozzáadása vagy módosításakor nevű eseményindító elindít egy munkafolyamatot, amikor egy fájlt hozzáadnak vagy módosítanak egy SFTP-kiszolgálón. További műveletként hozzáadhat egy feltételt, amely ellenőrzi, hogy a fájl tartalma megfelel-e a megadott feltételeknek. Ha a tartalom megfelel a feltételnek, a Fájltartalom lekérése művelet használatával kérje le a fájl tartalmát, majd egy másik művelet használatával helyezze a fájltartalmat egy másik mappába az SFTP-kiszolgálón.

SFTP-művelet hozzáadása

Ahhoz, hogy SFTP-műveletet használjon, a munkafolyamatnak már egy eseményindítóval kell kezdődnie, amely tetszőleges típusú lehet. Használhatja például az általános ismétlődési beépített eseményindítót a munkafolyamat adott ütemezés szerinti elindításához.

  1. Az Azure Portalon nyissa meg a Consumption logikai alkalmazást a tervező munkafolyamatával.

  2. A tervezőben kövesse az alábbi általános lépéseket a kívánt SFTP-SSH-művelet hozzáadásához.

  3. Ha a rendszer kéri, adja meg a szükséges kapcsolati adatokat. Amikor elkészült, válassza a Létrehozás lehetőséget.

  4. A műveletinformációs mező megjelenése után adja meg a kiválasztott művelethez szükséges adatokat. További információ: SFTP-SSH által felügyelt összekötőműveletek referenciája.

  5. Ha végzett, mentse a munkafolyamatot. A tervező eszköztárán válassza a Mentés lehetőséget.

A Fájltartalom lekérése elérési úttal nevű művelet például egy SFTP-kiszolgálón lévő fájlból szerzi be a tartalmat a fájl elérési útjának megadásával. Az előző példában szereplő eseményindítót és egy feltételt használhat, amelyet a fájltartalomnak teljesítenie kell. Ha a feltétel igaz, egy későbbi művelet lekérheti a tartalmat.

Hibaelhárítás

További információkért tekintse meg a következő dokumentációt:

Következő lépések