Compartilhar via

Conectar-se a um servidor de arquivos SFTP por meio de fluxos de trabalho nos Aplicativos Lógicos do Azure

  • Artigo

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

Esse guia de instruções mostra como acessar seu servidor SFTP (SSH File Transfer Protocol) por meio de um fluxo de trabalho nos Aplicativos Lógicos do Azure. O SFTP é um protocolo de rede que fornece acesso, transferência e gerenciamento de arquivos em qualquer fluxo de dados confiável e usa o protocolo SSH (Secure Shell).

Nos fluxos de trabalho de aplicativos lógicos de Consumo, você pode usar o conector gerenciadoSFTP-SSH, enquanto nos fluxos de trabalho de aplicativos lógicos Standard, você pode usar o conector interno SFTP ou o conector gerenciado SFTP-SSH. Em seguida, você pode usar essas operações do conector para criar fluxos de trabalho automatizados que são executados quando disparados por eventos no seu servidor SFTP ou em outros sistemas e executam ações para gerenciar arquivos no servidor SFTP. Os conectores gerenciados e internos usam o protocolo SSH.

Observação

O conector SFTPgerenciado foi preterido, portanto, as operações desse conector não aparecem mais no designer de fluxo de trabalho.

Por exemplo, seu fluxo de trabalho pode começar com um gatilho de SFTP que monitora eventos e responde a eles no servidor SFTP. O gatilho disponibiliza as saídas para as ações subsequentes no seu fluxo de trabalho. Seu fluxo de trabalho pode executar ações de SFTP que obtêm, criam e gerenciam arquivos por meio da sua conta do servidor SFTP. A seguinte lista inclui mais exemplos de tarefas:

  • Monitorar quando arquivos são adicionados ou alterados.
  • Obter, criar, copiar, renomear, atualizar, listar e excluir arquivos.
  • Crie pastas.
  • Obter conteúdo e metadados do arquivo.
  • Extrair o arquivo para pastas.

As etapas a seguir usam o portal do Azure, mas com a extensão de Aplicativos Lógicos do Azure apropriada; você também pode usar as seguintes ferramentas para criar fluxos de trabalho de aplicativo lógico:

Referência técnica do conector

O conector de SFTP tem diferentes versões, com base no tipo de aplicativo lógico e no ambiente do host.

Tipo de aplicativo lógico (plano) Ambiente Versão do conector
Consumo Aplicativos Lógicos do Azure Multilocatários Conector gerenciado, que aparece no designer sob o rótulo Standard. Para saber mais, consulte a seguinte documentação:

- Referência do conector gerenciado de SFTP-SSH
- Conectores gerenciados em Aplicativos Lógicos do Azure
Consumo Ambiente do serviço de integração (ISE) O conector gerenciado, que é exibido no designer sob o rótulo Standard, e a versão ISE, que é exibida no designer com o rótulo ISE e tem limites de mensagens diferentes do conector gerenciado. Para saber mais, consulte a seguinte documentação:

- Referência do conector gerenciado de SFTP-SSH
- Limites de mensagem ISE
- Conectores gerenciados em Aplicativos Lógicos do Azure
Standard Aplicativos Lógicos do Azure de locatário único e Ambiente do Serviço de Aplicativo v3 (somente planos Windows) O conector gerenciado, que aparece na galeria de conectores em Runtime>Compartilhado, e o conector interno (versão prévia), que aparece na galeria de conectores em Runtime>No Aplicativo e é baseado no provedor de serviços. O conector interno pode se conectar diretamente a um servidor SFTP e acessar redes virtuais do Azure usando uma cadeia de conexão sem um gateway de dados local. Para saber mais, consulte a seguinte documentação:

- Referência do conector gerenciado de SFTP-SSH
- Referência do conector interno de SFTP

- Conectores gerenciados em Aplicativos Lógicos do Azure
- Conectores internos em Aplicativos Lógicos do Azure

Limitações gerais

Problemas conhecidos

Por padrão, os gatilhos que retornam uma matriz têm uma configuração Split On já habilitada. Com essa configuração habilitada, o gatilho faz debatch automaticamente na matriz criando internamente uma instância de fluxo de trabalho separada para processar cada item de 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.

No entanto, quando a configuração Split On está habilitada, os gatilhos de conector gerenciado retornam as saídas para todos os itens de matriz como listas. Todas as ações subsequentes que fazem referência a essas saídas precisam primeiro tratá-las como listas. Para manipular cada item de matriz individualmente, você pode adicionar ações extras. Por exemplo, para iterar por meio desses itens de matriz, você pode usar um loop Para cada. Para gatilhos que retornam apenas metadados ou propriedades, use uma ação que primeiro obtenha os metadados do item de matriz e, em seguida, use uma ação para obter o conteúdo dos itens.

Você só precisa aplicar essa abordagem para gatilhos de conector gerenciado, não para gatilhos de conector interno que retornam saídas para um item de matriz por vez quando a configuração Dividir Em está habilitada.

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

  1. Obter metadados do arquivo para obter metadados de cada arquivo.

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

Agrupamento

Para obter mais informações sobre como o conector gerenciado de SFTP-SSH pode processar arquivos grandes que excedem os limites de tamanho padrão, confira Referência do conector gerenciado de SFTP-SSH – Divisão.

Pré-requisitos

  • Uma conta e uma assinatura do Azure. Se você não tiver uma assinatura do Azure, inscreva-se em uma conta gratuita do Azure.

  • Informações de conexão e autenticação para acessar o servidor SFTP, como o endereço do servidor, as credenciais da conta, o acesso a uma chave privada SSH e a senha da chave privada SSH. Para obter mais informações, confira Referência do conector gerenciado de SFTP-SSH – Autenticação e permissões.

    Importante

    Ao criar sua conexão e inserir sua chave privada SSH na propriedade Chave privada SSH, siga as etapas para fornecer o valor completo e correto dessa propriedade. Caso contrário, uma chave não válida causará uma falha na conexão.

  • O fluxo de trabalho do aplicativo lógico que você deseja acessar a sua conta SFTP. Para iniciar com um gatilho de SFTP-SSH, você precisará começar com um fluxo de trabalho em branco. Para usar uma ação de SFTP-SSH, inicie seu fluxo de trabalho com outro gatilho, como o gatilho Recorrência.

Adicionar um gatilho de SFTP

  1. No portal do Azure, abra seu aplicativo de lógica de Consumo com fluxo de trabalho em branco no designer.

  2. No designer, siga estas etapas gerais para adicionar o gatilho SFTP-SSH desejado.

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

  4. Depois que a caixa de informações do gatilho for exibida, forneça os detalhes necessários do gatilho escolhido. Para obter mais informações, confira Referência de gatilhos do conector gerenciado de SFTP-SSH.

  5. Quando terminar, salve o fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Quando você salva o fluxo de trabalho, essa etapa publica automaticamente suas atualizações no aplicativo lógico implantado, que está ativo no Azure. Com um gatilho apenas, o fluxo de trabalho só verifica o servidor FTP com base no seu agendamento especificado. Você precisa adicionar uma ação que responda ao gatilho e adote alguma ação quanto às saídas do gatilho.

Por exemplo, o gatilho chamado Quando um arquivo é adicionado ou modificado inicia um fluxo de trabalho quando um arquivo é adicionado ou alterado em um servidor SFTP. Como uma ação posterior, você pode adicionar uma condição que verifica se o conteúdo do arquivo atende aos critérios especificados. Se o conteúdo atender à condição, use a ação chamada Obter conteúdo do arquivo para obter o conteúdo do arquivo e outra ação para colocar o conteúdo desse arquivo em uma pasta diferente no servidor SFTP.

Adicionar uma ação de SFTP

Para que você possa usar uma ação de SFTP, seu fluxo de trabalho já precisa iniciar com um gatilho, que pode ser qualquer tipo de sua escolha. Por exemplo, você pode usar o gatilho interno genérico Recorrência para iniciar seu fluxo de trabalho com agendamento específico.

  1. No portal do Azure, abra seu aplicativo lógico de Consumo com fluxo de trabalho no designer.

  2. No designer, siga estas etapas gerais para adicionar a ação SFTP-SSH desejada.

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

  4. Depois que a caixa de informações da ação for exibida, forneça os detalhes necessários da ação escolhida. Para obter mais informações, confira Referência de ações do conector gerenciado de SFTP-SSH.

  5. Quando terminar, salve o fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Por exemplo, a ação chamada Obter conteúdo do arquivo usando o caminho obtém o conteúdo de um arquivo em um servidor SFTP especificando o caminho do arquivo. Você pode usar o gatilho do exemplo anterior e uma condição que o conteúdo do arquivo precisa atender. Se a condição for verdadeira, uma ação posterior poderá obter o conteúdo.

Solução de problemas

Para saber mais, confira a seguinte documentação:

Próximas etapas