Liga-te a ficheiros em servidores SFTP via Secure Shell (SSH) a partir de fluxos de trabalho no Azure Logic Apps

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Quando o seu fluxo de trabalho precisar de realizar uma gestão automatizada e segura de ficheiros em servidores que utilizam o Secure Shell (SSH) File Transfer Protocol (SFTP), utilize as operações de conector SFTP-SSH ou SFTP nos fluxos de trabalho que cria com Azure Logic Apps.

SFTP é um protocolo de rede que proporciona acesso a ficheiros, transferência de ficheiros e gestão de ficheiros sobre qualquer fluxo de dados fiável. Depois podes monitorizar, transferir e gerir ficheiros no teu servidor SFTP sem escrever código personalizado ou gerir infraestrutura. Caso contrário, tentar gerir manualmente estas operações de ficheiros pode ser demorado, propenso a erros e difícil de escalar.

Por exemplo, o seu fluxo de trabalho pode completar as seguintes tarefas:

• Monitorizar e processar ficheiros de dados recebidos.
• Cria e gere pastas e ficheiros.
• Obtenha conteúdo e metadados de arquivos. Extrair arquivos.
• Distribuir relatórios.
• Sincroniza o conteúdo entre ambientes.

Este guia mostra como aceder ao seu servidor SFTP a partir de um fluxo de trabalho no Azure Logic Apps.

Para obter mais informações, consulte:

• SSH (Protocolo de Transferência de Ficheiros SFTP)
• Secure Shell (SSH)

Referência técnica do conector

O conector SFTP-SSH tem diferentes versões, consoante o tipo de aplicação lógica e o ambiente do anfitrião.

Os fluxos de trabalho de Consumo e Standard podem usar o conector SFTP-SSHmanaged, que partilha computação com outros recursos em multitenant Azure. Os fluxos de trabalho padrão também podem usar o conector nativo durante a execução ou o conector SFTP incorporado. Ambas as versões dos conectores utilizam o protocolo SSH.

Diferentes versões de conectores SFTP oferecem diferentes operações pré-construídas. Podes iniciar um fluxo de trabalho em branco com um gatilho específico para SFTP, ou escolher um gatilho diferente, consoante o teu cenário. Por exemplo, pode iniciar o seu fluxo de trabalho com um gatilho SFTP que monitoriza e responde a eventos no seu servidor SFTP. O gatilho fornece saídas para usar com ações subsequentes no seu fluxo de trabalho. Várias ações SFTP desempenham diferentes tarefas, como obter, criar e gerir ficheiros no seu servidor SFTP.

Pré-requisitos

• Uma conta e assinatura do Azure. Crie uma conta Azure gratuita.

• Informações sobre a ligação e autenticação do seu servidor SFTP:

  • Endereço do servidor
  • Credenciais da conta
  • Acesso a uma chave privada SSH
  • Palavra-passe de chave privada SSH

  Importante

  Quando criar a sua ligação e inserir a sua chave privada SSH no parâmetro da chave privada SSH , certifique-se de seguir os passos para fornecer o valor completo e correto do parâmetro. Caso contrário, uma chave inválida faz com que a ligação falhe.

  Para obter mais informações, consulte Referência do conector gerenciado SFTP-SSH - Autenticação e permissões.

• O fluxo de trabalho onde quer aceder ao seu servidor SFTP.

  Para iniciar o seu fluxo de trabalho com um gatilho SFTP, precisa de um fluxo de trabalho em branco. Para usar uma ação SFTP, usa qualquer gatilho que funcione melhor para o teu cenário. O exemplo deste guia utiliza o gatilho de Recorrência.

Limitações gerais

• Antes de usar o conector gerenciado SFTP-SSH, consulte Referência do conector gerenciado SFTP-SSH - problemas e limitações conhecidos.

• Antes de usar o conector interno SFTP, consulte Referência do conector interno SFTP - problemas e limitações conhecidos.

Problemas conhecidos

Por padrão, os gatilhos que aceitam e retornam matrizes geralmente têm uma configuração Dividir em que já está habilitada. O gatilho decompõe automaticamente uma matriz criando internamente uma instância de fluxo de trabalho separada para processar cada elemento da matriz. Todas as instâncias de fluxo de trabalho são executadas em paralelo para que os itens de matriz sejam processados ao mesmo tempo.

Com a configuração Dividir em ativada, os gatilhos do conector gerenciado retornam as saídas de todos os itens do array como listas. Quaisquer ações subsequentes que façam referência a essas saídas devem primeiro lidar com essas saídas como listas. Para lidar com cada item de matriz individualmente, você pode adicionar ações extras. Por exemplo, para percorrer estes itens de matriz, pode-se usar um ciclo Para cada. Para gatilhos que retornam apenas metadados ou propriedades, use uma ação que obtenha os metadados do item de matriz primeiro e, em seguida, use uma ação para obter o conteúdo dos itens.

Você deve aplicar essa abordagem apenas para gatilhos de conector gerenciados, e não para gatilhos de conector internos que retornam saídas para cada item da matriz quando a configuração Dividir em está habilitada.

Por exemplo, suponha que você tenha um gatilho de conector gerenciado chamado Quando um arquivo é adicionado ou modificado (somente propriedades) que retorna os metadados ou propriedades dos arquivos novos ou atualizados como matrizes. Para obter os metadados separadamente para cada arquivo, você pode usar um Para cada loop que itera através da matriz. Nesse loop, use as seguintes ações de conectores geridos na ordem especificada:

1. Obtenha metadados de arquivo para obter os metadados de cada arquivo.

2. Obter conteúdo do arquivo para a ação de obter o conteúdo de cada ficheiro.

Segmentação

O chunking permite que uma operação trate de ficheiros grandes que excedam os limites de tamanho padrão. Para mais informações sobre o conector gerido SFTP-SSH e o suporte a fragmentação, consulte Referência do conector gerido SFTP-SSH - Fragmentação.

Adicionar um gatilho SFTP

Para adicionar um gatilho SFTP ao seu fluxo de trabalho em branco, siga os passos correspondentes:

Adicionar um acionador de SFTP-SSH gerido (Consumo, Padrão)

Para adicionar e configurar um gatilho de conector SFTP-SSH gerido ou partilhado, siga estes passos:

1. No portal Azure, abra o recurso da aplicação lógica. No designer, abre o fluxo de trabalho em branco.

2. No designer, segue os passos gerais para adicionar o gatilho SFTP-SSH partilhado que queres.

   Por exemplo, o gatilho SFTP-SSH chamado Quando um ficheiro é adicionado ou modificado inicia o fluxo de trabalho quando um ficheiro no seu servidor SFTP é adicionado ou alterado. Pode adicionar uma ação de condição que verifique se o conteúdo do ficheiro cumpre os critérios especificados. Se o conteúdo cumprir os critérios, use a ação SFTP chamada Get file content e depois use outra ação para guardar o conteúdo numa pasta SFTP diferente.

3. Se solicitado, forneça as informações de conexão necessárias. Quando terminar, selecione Criar novo.

4. No designer, selecione o gatilho, caso não esteja selecionado. No painel de informação de gatilho, forneça os detalhes necessários.

   Para obter mais informações, consulte Referência de gatilhos de conector gerenciado SFTP-SSH.

5. Quando terminar, salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

6. Continue a construir o seu fluxo de trabalho adicionando ações.

Adicione um gatilho SFTP incorporado (apenas Standard)

Para adicionar e configurar um gatilho de conector SFTP incorporado, siga estes passos:

1. No portal Azure, abra o recurso da aplicação lógica. No designer, abre o fluxo de trabalho em branco.

2. No designer, siga os passos gerais para adicionar o gatilho SFTP incorporado que deseja.

   Por exemplo, o gatilho SFTP chamado Quando um ficheiro é adicionado ou modificado inicia o fluxo de trabalho quando um ficheiro no seu servidor SFTP é adicionado ou alterado. Pode adicionar uma ação de condição que verifique se o conteúdo do ficheiro cumpre os critérios especificados. Se o conteúdo cumprir os critérios, use a ação SFTP chamada Get file content e depois use outra ação para guardar o conteúdo numa pasta SFTP diferente.

3. Se solicitado, forneça as informações de conexão necessárias. Quando terminar, selecione Criar novo.

4. No designer, selecione o gatilho, caso não esteja selecionado. No painel de informação de gatilho, forneça os detalhes necessários.

   Para mais informações, consulte a referência de gatilho do conector incorporado do SFTP.

5. Quando terminar, salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

6. Continue a construir o seu fluxo de trabalho adicionando ações.

Adicionar uma ação SFTP

Antes de adicionares uma ação SFTP, o teu fluxo de trabalho exige um gatilho, que pode ser o que funcionar melhor para o teu cenário.

Este exemplo utiliza o gatilho genérico Recurrence incorporado, que executa o seu fluxo de trabalho com base num calendário especificado. Pode adicionar um SFTP

Adicionar uma ação de SFTP-SSH gerida (Consumo, Padrão)

Para adicionar e configurar uma ação gerida do conector SFTP-SSH , siga estes passos:

1. No portal do Azure, abra seu recurso de aplicativo lógico. No designer, abre o teu fluxo de trabalho.

2. No designer, siga os passos gerais para adicionar a ação partilhada SFTP-SSH que deseja.

   Por exemplo, a ação SFTP-SSH chamada Obter conteúdo do ficheiro usando caminho obtém o conteúdo do ficheiro de um servidor SFTP ao indicar o caminho do ficheiro. Pode usar o gatilho SFTP-SSH para verificar ficheiros novos ou atualizados e uma ação de condição que especifique critérios que o conteúdo deve cumprir. Se o conteúdo cumprir os critérios, use a ação Obter conteúdo do ficheiro usando o caminho e uma ação subsequente para guardar o conteúdo numa pasta SFTP diferente.

3. Se solicitado, forneça as informações de conexão necessárias. Quando terminar, selecione Criar novo.

4. No editor de design, selecione a ação, se não estiver já selecionada. No painel de informação da ação, forneça os detalhes necessários.

   Para obter mais informações, consulte Referência de ações do conector gerenciado SFTP-SSH.

5. Quando terminar, salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

Adicionar uma ação SFTP incorporada (apenas Standard)

Para adicionar e configurar uma ação SFTP incorporada, siga estes passos:

1. No portal do Azure, abra seu recurso de aplicativo lógico. No designer, abre o teu fluxo de trabalho.

2. No designer, segue os passos gerais para adicionar a ação SFTP-SSH incorporada que queres.

   Por exemplo, a ação SFTP chamada Get file content recebe o conteúdo do ficheiro num servidor SFTP. Pode usar o gatilho SFTP que verifica ficheiros novos ou atualizados e uma ação de condição que especifica critérios que o conteúdo do ficheiro deve cumprir. Se o conteúdo cumprir os critérios, use a ação Obter conteúdo do ficheiro e uma ação subsequente para guardar o conteúdo numa pasta SFTP diferente.

3. Se solicitado, forneça as informações de conexão necessárias. Quando terminar, selecione Criar novo.

4. No designer, seleciona a ação, se não estiver selecionada. No painel de informação da ação, forneça os detalhes necessários.

   Para obter mais informações, consulte Referência de ações do conector interno SFTP.

5. Quando terminar, salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.

Solucionar problemas

Para obter mais informações, consulte:

• Referência do conector gerenciado SFTP-SSH - Solução de problemas
• Referência do conector integrado SFTP - Solução de problemas

Conteúdo relacionado

• Conectores gerenciados para Aplicativos Lógicos do Azure
• Conectores integrados para Logic Apps do Azure