Conectar-se a um servidor de arquivos SFTP a partir de fluxos de trabalho nos Aplicativos Lógicos do Azure
Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)
Este guia de instruções mostra como aceder ao seu servidor SSH File Transfer Protocol (SFTP) a partir de um fluxo de trabalho nas Aplicações Lógicas do Azure. SFTP é um protocolo de rede que fornece acesso a arquivos, transferência de arquivos e gerenciamento de arquivos em qualquer fluxo de dados confiável e usa o protocolo Secure Shell (SSH).
Nos fluxos de trabalho do aplicativo lógico de consumo, você pode usar o conector gerenciado SFTP-SSH, enquanto nos fluxos de trabalho do aplicativo lógico padrão, você pode usar o conector interno SFTP ou o conector gerenciado SFTP-SSH. Você pode usar essas operações de conector para criar fluxos de trabalho automatizados que são executados quando acionados por eventos em seu servidor SFTP ou em outros sistemas e executar ações para gerenciar arquivos em seu servidor SFTP. Os conectores gerenciados e internos usam o protocolo SSH.
Nota
O conector gerenciado SFTPfoi 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 SFTP que monitora e responde a eventos em seu servidor SFTP. O gatilho disponibiliza as saídas para ações subsequentes em seu fluxo de trabalho. Seu fluxo de trabalho pode executar ações SFTP que obtêm, criam e gerenciam arquivos por meio de sua conta de servidor SFTP. A lista a seguir inclui mais tarefas de exemplo:
- Monitore quando os arquivos são adicionados ou alterados.
- Obter, criar, copiar, renomear, atualizar, listar e excluir arquivos.
- Crie pastas.
- Obtenha conteúdo e metadados de arquivos.
- Extraia arquivos para pastas.
As etapas a seguir usam o portal do Azure, mas com a extensão apropriada de Aplicativos Lógicos do Azure, você também pode usar as seguintes ferramentas para criar e editar fluxos de trabalho de aplicativos lógicos:
Fluxos de trabalho do aplicativo lógico de consumo: Visual Studio ou Visual Studio Code
Fluxos de trabalho de aplicativos lógicos padrão: Visual Studio Code
Referência técnica do conector
O conector SFTP tem diferentes versões, com base no tipo de aplicativo lógico e no ambiente de 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 Padrão . Para obter mais informações, consulte a seguinte documentação: - Referência do conector gerenciado SFTP-SSH - Conectores gerenciados nos Aplicativos Lógicos do Azure |
| Consumo | Ambiente de serviço de integração (ISE) | Conector gerenciado, que aparece no designer sob o rótulo Padrão, e a versão ISE, que aparece no designer com o rótulo ISE e tem limites de mensagem diferentes do conector gerenciado. Para obter mais informações, consulte a seguinte documentação: - Referência do conector gerenciado SFTP-SSH - Limites de mensagens ISE - Conectores gerenciados nos Aplicativos Lógicos do Azure |
| Standard | Aplicativos Lógicos do Azure e Ambiente do Serviço de Aplicativo v3 de locatário único (somente planos do Windows) | Conector gerenciado, que aparece na galeria de conectores em Runtime Shared, e o conector interno, que aparece na galeria de conectores em Runtime>>In-App e é baseado em 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 obter mais informações, consulte a seguinte documentação: - Referência do conector gerenciado SFTP-SSH - Referência do conector integrado SFTP - Conectores gerenciados nos Aplicativos Lógicos do Azure - Conectores internos nos Aplicativos Lógicos do Azure |
Limitações gerais
Antes de usar o conector gerenciado SFTP-SSH, revise os problemas e limitações conhecidos na referência do conector gerenciado SFTP-SSH.
Antes de usar o conector interno SFTP, revise os problemas conhecidos e as limitações na referência do conector interno SFTP.
Problemas conhecidos
Por padrão, os gatilhos que retornam uma matriz têm uma configuração Dividir em que já está habilitada. Com essa configuração habilitada, o gatilho desagrupa automaticamente a matriz criando internamente uma instância de fluxo de trabalho separada para processar cada item 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.
No entanto, quando a configuração Dividir em está habilitada, os gatilhos do conector gerenciado retornam as saídas para todos os itens da matriz 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 iterar através desses itens de matriz, você pode usar um Para cada loop. 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ê precisa aplicar essa abordagem apenas para gatilhos de conector gerenciados, não gatilhos de conector internos que retornam saídas para um item de matriz de cada vez 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 do conector gerenciado na ordem especificada:
Obtenha metadados de arquivo para obter os metadados de cada arquivo.
Obter ação de conteúdo de arquivo para obter o conteúdo de cada arquivo.
Fragmentação
Para obter mais informações sobre como o conector gerenciado SFTP-SSH pode lidar com arquivos grandes que excedem os limites de tamanho padrão, consulte Referência do conector gerenciado SFTP-SSH - Fragmentação.
Pré-requisitos
Uma conta e subscrição do Azure. Se não tiver uma subscrição do Azure, inscreva-se para obter uma conta do Azure gratuita.
Informações de conexão e autenticação para acessar seu servidor SFTP, como o endereço do servidor, credenciais da conta, acesso a uma chave privada SSH e a senha da chave privada SSH. Para obter mais informações, consulte Referência do conector gerenciado SFTP-SSH - Autenticação e permissões.
Importante
Ao criar sua conexão e inserir sua chave privada SSH na propriedade de chave privada SSH, certifique-se de seguir as etapas para fornecer o valor completo e correto para essa propriedade. Caso contrário, uma chave inválida fará com que a conexão falhe.
O fluxo de trabalho do aplicativo lógico onde você deseja acessar sua conta SFTP. Para começar com um gatilho SFTP-SSH, você precisa começar com um fluxo de trabalho em branco. Para usar uma ação SFTP-SSH, inicie seu fluxo de trabalho com outro gatilho, como o gatilho Recorrência .
Adicionar um gatilho SFTP
No portal do Azure, abra seu aplicativo lógico de consumo com fluxo de trabalho em branco no designer.
No designer, siga estas etapas gerais para adicionar o gatilho SFTP-SSH desejado.
Se solicitado, forneça as informações de conexão necessárias. Quando tiver terminado, selecione Criar.
Depois que a caixa de informações do gatilho for exibida, forneça os detalhes necessários para o gatilho selecionado. Para obter mais informações, consulte Referência de gatilhos de conector gerenciado SFTP-SSH.
Quando terminar, salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.
Quando você salva seu fluxo de trabalho, esta etapa publica automaticamente suas atualizações em seu aplicativo lógico implantado, que está ativo no Azure. Com apenas um gatilho, seu fluxo de trabalho apenas verifica o servidor FTP com base em sua programação especificada. Você tem que adicionar uma ação que responde ao gatilho e faz algo com as 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 ação subsequente, você pode adicionar uma condição que verifique 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, em seguida, use outra ação para colocar esse conteúdo de arquivo em uma pasta diferente no servidor SFTP.
Adicionar uma ação SFTP
Antes de poder usar uma ação SFTP, seu fluxo de trabalho já deve começar com um gatilho, que pode ser de qualquer tipo que você escolher. Por exemplo, você pode usar o gatilho interno genérico Recorrência para iniciar seu fluxo de trabalho em um cronograma específico.
No portal do Azure, abra seu aplicativo lógico de consumo com fluxo de trabalho no designer.
No designer, siga estas etapas gerais para adicionar a ação SFTP-SSH desejada.
Se solicitado, forneça as informações de conexão necessárias. Quando tiver terminado, selecione Criar.
Depois que a caixa de informações da ação for exibida, forneça os detalhes necessários para a ação selecionada. Para obter mais informações, consulte Referência de ações do conector gerenciado SFTP-SSH.
Quando terminar, salve seu fluxo de trabalho. Na barra de ferramentas do estruturador, selecione Guardar.
Por exemplo, a ação chamada Obter conteúdo de arquivo usando 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 deve atender. Se a condição for verdadeira, uma ação subsequente pode obter o conteúdo.
Resolução de problemas
Para obter mais informações, consulte a seguinte documentação:
- Referência do conector gerenciado SFTP-SSH - Solução de problemas
- Referência do conector integrado SFTP - Solução de problemas