Csatlakozás SFTP-fájlkiszolgálóhoz az Azure Logic Apps munkafolyamataiból
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 logikaialkalmazás-munkafolyamatokat:
- Használati munkafolyamatok: Visual Studio Code
- Standard munkafolyamatok: Visual Studio Code
Ö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 |
|---|---|---|
| Használat | Több-bérlős Azure Logic Apps | Felügyelt összekötő, amely az összekötő katalógusában, a Megosztott futtatókörnyezet>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 |
| 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 Runtime>Shared és a beépített összekötő alatt jelenik meg, 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
Az SFTP-SSH felügyelt összekötő használata előtt tekintse meg az SFTP-SSH által felügyelt összekötőkre vonatkozó referenciát – ismert problémákat és korlátozásokat.
A beépített SFTP-összekötő használata előtt tekintse meg az SFTP beépített összekötői referenciáját – ismert problémákat és korlátozásokat.
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:
Kérje le a fájl metaadatait az egyes fájlok metaadatainak lekéréséhez.
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
Az Azure Portalon nyissa meg a Consumption logikai alkalmazást üres munkafolyamattal a tervezőben.
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.
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.
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.
Miután 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.
Az Azure Portalon nyissa meg a Consumption logikai alkalmazást a tervező munkafolyamatával.
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.
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.
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.
Miután 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:
- Felügyelt SFTP-SSH-összekötő referenciája – Hibaelhárítás
- SFTP beépített összekötőre vonatkozó referencia – Hibaelhárítás