Connettersi ai file nei server SFTP tramite Secure Shell (SSH) dai flussi di lavoro in App per la logica di Azure

Si applica a: App per la logica di Azure (Consumption + Standard)

Quando il flusso di lavoro deve eseguire la gestione automatica e sicura dei file nei server che usano SECURE Shell (SSH) File Transfer Protocol (SFTP), usare le operazioni del connettore SFTP-SSH o SFTP nei flussi di lavoro creati con App per la logica di Azure.

SFTP è un protocollo di rete che fornisce l'accesso ai file, il trasferimento di file e la gestione dei file su qualsiasi flusso di dati affidabile. È quindi possibile monitorare, trasferire e gestire i file nel server SFTP senza scrivere codice personalizzato o gestire l'infrastruttura. In caso contrario, il tentativo di gestire manualmente queste operazioni di file può richiedere molto tempo, soggetto a errori e difficile da ridimensionare.

Ad esempio, il flusso di lavoro può completare le attività seguenti:

Monitorare ed elaborare i file di dati in ingresso.
Creare e gestire cartelle e file.
Leggere contenuti e metadati dei file. Estrarre gli archivi.
Distribuire i report.
Sincronizzare il contenuto tra ambienti.

Questa guida illustra come accedere al server SFTP da un flusso di lavoro in App per la logica di Azure.

Per ulteriori informazioni consulta:

Informazioni tecniche sul connettore

Il connettore SFTP-SSH ha versioni diverse, in base al tipo di app per la logica e all'ambiente host.

I flussi di lavoro a consumo e Standard possono usare il connettore SFTP-SSHmanaged, che condivide il calcolo con altre risorse in Azure multi-tenant. I flussi di lavoro standard possono anche utilizzare il connettore SFTP nativo per runtime o integrato. Entrambe le versioni del connettore usano il protocollo SSH.

Tipo di applicazione logica (piano)	Ambiente	Versione del connettore
Consumo	App per la logica di Azure multi-tenant	Connettore gestito, visualizzato nella raccolta connettori sotto il filtro Condiviso . Per altre informazioni, vedere riferimento al connettore gestito SFTP-SSH.
Standard	App per la logica di Azure a tenant singolo, ambiente del servizio app v3 (solo piano Windows) e Soluzione Ibrida	- Connettore gestito, visualizzato nella raccolta connettori sotto il filtro Condiviso . - Connettore predefinito, visualizzato nella raccolta connettori sotto il filtro predefinito ed è basato sul provider di servizi. Il connettore predefinito può connettersi direttamente a un server SFTP e accedere alle reti virtuali di Azure usando un stringa di connessione senza un gateway dati locale. Per altre informazioni, vedere: - Informazioni di riferimento sul connettore gestito SFTP-SSH - Informazioni di riferimento sul connettore predefinito SFTP

Diverse versioni del connettore SFTP offrono diverse operazioni predefinite. È possibile avviare un flusso di lavoro vuoto con un trigger specifico di SFTP oppure scegliere un trigger diverso in base allo scenario in uso. Ad esempio, è possibile avviare il flusso di lavoro con un trigger SFTP che monitora e risponde agli eventi nel server SFTP. Il trigger fornisce output da usare con le azioni successive nel flusso di lavoro. Varie azioni SFTP eseguono diverse attività, ad esempio ottenere, creare e gestire file nel server SFTP.

Prerequisiti

Account e sottoscrizione di Azure. Ottenere un account Azure gratuito.
Informazioni sulla connessione e l'autenticazione del server SFTP:
- Indirizzo server
- Credenziali dell'account
- Accesso a una chiave privata SSH
- Password della chiave privata SSH
Importante

Quando si crea la connessione e si immette la chiave privata SSH nel parametro chiave privata SSH , assicurarsi di seguire la procedura per fornire il valore completo e corretto del parametro. In caso contrario, una chiave non valida causa l'esito negativo della connessione.

Per altre informazioni, vedere Informazioni di riferimento sul connettore gestito SFTP-SSH - Autenticazione e autorizzazioni.
Flusso di lavoro in cui si vuole accedere al server SFTP.

Per avviare il flusso di lavoro con un trigger SFTP, è necessario un flusso di lavoro vuoto. Per usare un'azione SFTP, usare qualunque trigger che funzioni meglio per il tuo scenario. L'esempio in questa guida usa il trigger Ricorrenza .

Limitazioni generali

Prima di usare il connettore gestito SFTP-SSH, vedere Informazioni di riferimento sul connettore gestito SFTP-SSH- Problemi noti e limitazioni.
Prima di usare il connettore predefinito SFTP, vedere Informazioni di riferimento sul connettore predefinito SFTP- Problemi noti e limitazioni.

Problemi noti

Per impostazione predefinita, i trigger che accettano e restituiscono matrici hanno in genere un'impostazione Split on che è già abilitata. Il trigger discute automaticamente una matrice creando internamente un'istanza del flusso di lavoro separata per elaborare ogni elemento della matrice. Tutte le istanze del flusso di lavoro vengono eseguite in parallelo in modo che gli elementi della matrice vengano elaborati contemporaneamente.

Con l'impostazione Split on abilitata, i trigger del connettore gestito restituiscono gli output per tutti gli elementi della matrice come elenchi. Tutte le azioni successive che fanno riferimento a questi output devono prima gestire questi output come elenchi. Per gestire singolarmente ogni elemento di matrice, è possibile aggiungere azioni aggiuntive. Ad esempio, per scorrere questi elementi di array, è possibile utilizzare un ciclo For each. Per i trigger che restituiscono solo metadati o proprietà, usare un'azione che ottiene prima i metadati dell'elemento della matrice e quindi usare un'azione per ottenere il contenuto degli elementi.

È necessario applicare questo approccio solo per i trigger del connettore gestito , non per i trigger del connettore predefiniti che restituiscono output per un elemento di matrice alla volta con l'impostazione Split on abilitata.

Si supponga, ad esempio, di avere un trigger del connettore gestito denominato Quando un file viene aggiunto o modificato (solo proprietà) che restituisce i metadati o le proprietà per i file nuovi o aggiornati come matrici. Per ottenere i metadati separatamente per ogni file, è possibile usare un ciclo For each che scorre la matrice. In questo ciclo usare le azioni del connettore gestito seguenti nell'ordine specificato:

Ottenere i metadati del file per ottenere i metadati di ogni file.
Ottieni il contenuto del file per ottenere il contenuto di ogni file.

Suddivisione in blocchi

La suddivisione in blocchi consente a un'operazione di gestire file di grandi dimensioni che superano i limiti di dimensione predefiniti. Per altre informazioni sul connettore gestito SFTP-SSH e sul supporto della suddivisione in blocchi, vedere SFTP-SSH riferimento al connettore gestito - Suddivisione in blocchi.

Aggiungere un trigger SFTP

Per aggiungere un trigger SFTP al flusso di lavoro vuoto, seguire la procedura corrispondente:

Aggiungere un trigger di SFTP-SSH gestito (Consumo, Standard)

Per aggiungere e configurare un trigger del connettore SFTP-SSH gestito o condiviso, seguire questa procedura:

Nel portale di Azure aprire la risorsa dell'app per la logica. Nella finestra di progettazione aprire il flusso di lavoro vuoto.
Nella finestra di progettazione seguire i passaggi generali per aggiungere il trigger SFTP-SSHcondiviso desiderato.

Ad esempio, il trigger SFTP-SSH denominato Quando viene aggiunto o modificato un file avvia il flusso di lavoro quando viene aggiunto o modificato un file nel server SFTP. È possibile aggiungere un'azione condizione che controlla se il contenuto del file soddisfa i criteri specificati. Se il contenuto soddisfa i criteri, usare l'azione SFTP denominata Recupera contenuto file e quindi usare un'altra azione per salvare il contenuto in una cartella SFTP diversa.
Se richiesto, specificare le informazioni di connessione necessarie. Al termine, selezionare Crea nuovo.
Nella finestra di progettazione selezionare il trigger, se non selezionato. Nel riquadro informazioni sul trigger specificare i dettagli necessari.

Per altre informazioni, vedere Informazioni di riferimento sui trigger del connettore gestito SFTP-SSH.
Al termine, salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.
Continuare a sviluppare il flusso di lavoro aggiungendo azioni.

Aggiungere un trigger SFTP predefinito (solo Standard)

Per aggiungere e configurare un trigger predefinito del connettore SFTP , seguire questa procedura:

Nel portale di Azure aprire la risorsa dell'app per la logica. Nella finestra di progettazione aprire il flusso di lavoro vuoto.
Nella finestra di progettazione seguire i passaggi generali per aggiungere il trigger SFTPpredefinito desiderato.

Ad esempio, il trigger SFTP denominato Quando viene aggiunto o modificato un file avvia il flusso di lavoro quando viene aggiunto o modificato un file nel server SFTP. È possibile aggiungere un'azione condizione che controlla se il contenuto del file soddisfa i criteri specificati. Se il contenuto soddisfa i criteri, usare l'azione SFTP denominata Recupera contenuto file e quindi usare un'altra azione per salvare il contenuto in una cartella SFTP diversa.
Se richiesto, specificare le informazioni di connessione necessarie. Al termine, selezionare Crea nuovo.
Nella finestra di progettazione selezionare il trigger, se non selezionato. Nel riquadro informazioni sul trigger specificare i dettagli necessari.

Per altre informazioni, vedere Informazioni di riferimento sul trigger del connettore predefinito SFTP.
Al termine, salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.
Continua a costruire il tuo flusso di lavoro aggiungendo azioni.

Aggiungere un'azione SFTP

Prima di aggiungere un'azione SFTP, il flusso di lavoro richiede un trigger, che può essere il migliore per lo scenario.

In questo esempio viene usato il trigger predefinito Ricorrenza generica, che esegue il flusso di lavoro in base a una pianificazione specificata. È possibile aggiungere un SFTP

Aggiungere un'azione di SFTP-SSH gestita (Consumo, Standard)

Per aggiungere e configurare un'azione del connettore SFTP-SSH gestita, seguire questa procedura:

Nel portale di Azure, apri la risorsa dell'app logica. Nella finestra di progettazione aprire il flusso di lavoro.
Nella finestra di progettazione seguire i passaggi generali per aggiungere l'azione condivisa SFTP-SSH desiderata.

Ad esempio, l'azione SFTP-SSH denominata Get file content using path ottiene il contenuto del file da un server SFTP specificando il percorso del file. È possibile usare il trigger di SFTP-SSH per verificare la presenza di file nuovi o aggiornati e un'azione condizione che specifica i criteri che il contenuto deve soddisfare. Se il contenuto soddisfa i criteri, usare l'azione Recupera contenuto file usando il percorso e un'azione successiva per salvare il contenuto in una cartella SFTP diversa.
Se richiesto, specificare le informazioni di connessione necessarie. Al termine, selezionare Crea nuovo.
Nella finestra di progettazione selezionare l'azione, se non selezionata. Nel riquadro delle informazioni sull'azione specificare i dettagli necessari.

Per altre informazioni, vedere Informazioni di riferimento sulle azioni del connettore gestito SFTP-SSH.
Al termine, salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.

Aggiungere un'azione SFTP predefinita (solo Standard)

Per aggiungere e configurare un'azione SFTP predefinita, seguire questa procedura:

Nel portale di Azure, apri la risorsa dell'app logica. Nella finestra di progettazione aprire il flusso di lavoro.
Nella finestra di progettazione seguire i passaggi generali per aggiungere l'azione predefinita SFTP-SSH desiderata.

Ad esempio, l'azione SFTP denominata Recupera contenuto file ottiene il contenuto del file in un server SFTP. È possibile usare il trigger SFTP che verifica la presenza di file nuovi o aggiornati e un'azione condizione che specifica i criteri che il contenuto del file deve soddisfare. Se il contenuto soddisfa i criteri, usare l'azione Recupera contenuto file e un'azione successiva per salvare il contenuto in una cartella SFTP diversa.
Se richiesto, specificare le informazioni di connessione necessarie. Al termine, selezionare Crea nuovo.
Nel designer selezionare l'azione, se non è stata selezionata. Nel riquadro delle informazioni sull'azione specificare i dettagli necessari.

Per altre informazioni, vedere Informazioni di riferimento sulle azioni del connettore predefinite SFTP.
Al termine, salvare il flusso di lavoro. Sulla barra degli strumenti della finestra di progettazione seleziona Salva.

Risoluzione dei problemi