Conecte-se a arquivos em servidores SFTP via Secure Shell (SSH) a partir de fluxos de trabalho no Aplicativos Lógicos do Azure

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

Quando o fluxo de trabalho precisar executar o gerenciamento de arquivos automatizado e seguro em servidores que usam o Protocolo de Transferência de Arquivos SSH (SFTP), use as operações de conector SFTP-SSH ou SFTP nos fluxos de trabalho criados com Aplicativos Lógicos do Azure.

O 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. Em seguida, você pode monitorar, transferir e gerenciar arquivos em seu servidor SFTP sem escrever código personalizado ou gerenciar a infraestrutura. Caso contrário, tentar gerenciar manualmente essas operações de arquivo pode ser demorado, propenso a erros e difícil de dimensionar.

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

• Monitorar e processar arquivos de dados de entrada.
• Crie e gerencie pastas e arquivos.
• Obter conteúdo e metadados do arquivo. Extraia arquivos.
• Distribua relatórios.
• Sincronizar conteúdo entre ambientes.

Este guia mostra como acessar o servidor SFTP de um fluxo de trabalho em Aplicativos Lógicos do Azure.

Para obter mais informações, consulte:

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

Referência técnica do conector

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

O consumo e o fluxo de trabalho Standard podem usar o conector SFTP-SSHgerenciado, que compartilha a computação com outros recursos do Azure multilocatário. Os fluxos de trabalho padrão também podem usar o conector SFTPnativo do runtime ou interno. Ambas as versões do conector usam o protocolo SSH.

Diferentes versões do conector SFTP oferecem diferentes operações predefinidas. Você pode iniciar um fluxo de trabalho em branco com um gatilho específico do SFTP ou escolher um gatilho diferente, com base em seu cenário. Por exemplo, você pode iniciar seu fluxo de trabalho com um gatilho SFTP que monitora e responde a eventos em seu servidor SFTP. O gatilho fornece saídas a serem usadas com ações subsequentes em seu fluxo de trabalho. Várias ações SFTP executam tarefas diferentes, como obter, criar e gerenciar arquivos no servidor SFTP.

Pré-requisitos

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

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

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

  Importante

  Ao criar sua conexão e inserir sua chave privada SSH no parâmetro de chave privada SSH , siga as etapas para fornecer o valor de parâmetro completo e correto. Caso contrário, uma chave inválida fará com que a conexão falhe.

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

• O fluxo de trabalho no qual você deseja acessar o servidor SFTP.

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

Limitações gerais

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

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

Problemas conhecidos

Por padrão, gatilhos que aceitam e retornam matrizes geralmente têm a configuração de Dividir em já habilitada. O gatilho elimina automaticamente uma 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 Dividir em 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 referenciam essas saídas devem primeiro tratar essas saídas 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ê deve aplicar essa abordagem apenas para gatilhos de conector gerenciado, e não para gatilhos de conector internos que retornam saídas para um item de matriz de cada vez com a configuração Dividir em 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

O agrupamento permite que uma operação manipule arquivos grandes que excedem os limites de tamanho padrão. Para mais informações sobre o conector gerenciado SFTP-SSH e o suporte a chunking, consulte a referência do conector gerenciado SFTP-SSH – Chunking.

Adicionar um gatilho de SFTP

Para adicionar um gatilho SFTP ao fluxo de trabalho em branco, siga as etapas correspondentes:

Adicionar um disparador de SFTP-SSH gerenciado (Consumo, Padrão)

Para adicionar e configurar um gatilho de conector SFTP-SSH gerenciado ou compartilhado, siga estas etapas:

1. No portal do Azure, abra o recurso de aplicativo lógico. No designer, abra o fluxo de trabalho em branco.

2. No designer, siga as etapas gerais para adicionar o gatilho SFTP-SSHcompartilhado desejado.

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

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

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

   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.

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

Adicionar um gatilho SFTP interno (somente Standard)

Para adicionar e configurar um gatilho de conector SFTP interno, siga estas etapas:

1. No portal do Azure, abra o recurso de aplicativo lógico. No designer, abra o fluxo de trabalho em branco.

2. No designer, siga as etapas gerais para adicionar o gatilho SFTPinterno desejado.

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

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

4. No designer, selecione o gatilho, se não estiver selecionado. No painel de informações do gatilho, forneça os detalhes necessários.

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

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

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

Adicionar uma ação de SFTP

Antes de adicionar uma ação SFTP, seu fluxo de trabalho requer um gatilho, que pode ser o que funcionar melhor para seu cenário.

Este exemplo usa o gatilho interno genérico Recorrência, que executa seu fluxo de trabalho com base em um agendamento especificado. Você pode adicionar um SFTP

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

Para adicionar e configurar uma ação de conector SFTP-SSH gerenciado, siga estas etapas:

1. No portal Azure, abra o recurso de aplicativo lógico. Na ferramenta designer, abra o fluxo de trabalho.

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

   Por exemplo, a ação SFTP-SSH chamada Obter conteúdo do arquivo usando o caminho obtém o conteúdo do arquivo de um servidor SFTP especificando o caminho do arquivo. Você pode usar o gatilho SFTP-SSH para verificar se há arquivos novos ou atualizados e uma ação de condição que especifica os critérios que o conteúdo deve atender. Se o conteúdo atender aos critérios, use a ação Obter conteúdo do arquivo usando o caminho e uma ação subsequente para salvar o conteúdo em uma pasta SFTP diferente.

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

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

   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.

Adicionar uma ação SFTP interna (somente Standard)

Para adicionar e configurar uma ação SFTP interna, siga estas etapas:

1. No portal Azure, abra o recurso de aplicativo lógico. Na ferramenta designer, abra o fluxo de trabalho.

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

   Por exemplo, a ação SFTP chamada Obter conteúdo de arquivo obtém o conteúdo do arquivo em um servidor SFTP. Você pode usar o gatilho SFTP que verifica arquivos novos ou atualizados e uma ação de condição que especifica os critérios que o conteúdo do arquivo deve atender. Se o conteúdo atender aos critérios, use a ação Obter conteúdo do arquivo e uma ação subsequente para salvar o conteúdo em uma pasta SFTP diferente.

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

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

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

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

Solucionar problemas

Para obter mais informações, consulte:

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

Conteúdo relacionado

• Conectores gerenciados dos Aplicativos Lógicos do Azure
• Conectores internos de Aplicativos Lógicos do Azure