Compartilhar via

Tarefa FTP

  • Artigo

A tarefa FTP carrega e baixa arquivos de dados, bem como gerencia diretórios em servidores. Por exemplo, um pacote pode baixar arquivos de dados de um servidor remoto ou de um local de Internet como parte de um fluxo de trabalho de pacote do Integration Services. Você pode usar a tarefa FTP para os seguintes propósitos:

  • Copiar diretórios e arquivos de dados de um diretório para outro, antes ou depois de mover dados, e aplicar transformações nos dados.

  • Fazer logon em um local FTP de origem e copiar arquivos ou pacotes em um diretório de destino.

  • Baixar arquivos de um local FTP e aplicar transformações em dados de coluna antes de carregar os dados em um banco de dados.

Em tempo de execução, a tarefa FTP é conectada a um servidor usando um gerenciador de conexões de FTP. O gerenciador de conexões de FTP é configurado separadamente da tarefa FTP e, em seguida, é referido na tarefa FTP. O gerenciador de conexões de FTP inclui as configurações do servidor, as credenciais para acessar o servidor FTP e as opções como o tempo limite e o número de tentativas para conexão com o servidor. Para obter mais informações, consulte Gerenciador de Conexões de FTP.

Importante

O gerenciador de conexões de FTP dá suporte apenas para autenticação anônima e autenticação básica. Ele não suporta a Autenticação do Windows.

Ao acessar um arquivo local ou um diretório local, a tarefa FTP usa um gerenciador de conexões de arquivos ou informações de caminho armazenadas em uma variável. Por outro lado, ao acessar um arquivo remoto ou um diretório remoto, a tarefa FTP usa um caminho especificado diretamente no servidor remoto, conforme especificado no gerenciador de conexões de FTP, ou as informações de caminho armazenadas em uma variável. Para obter mais informações, confira Gerenciador de Conexões de Arquivos e Variáveis do Integration Services (SSIS).

Isso significa que a tarefa FTP pode receber vários arquivos e excluir diversos arquivos remotos, mas a tarefa só poderá enviar um arquivo e só poderá excluir um arquivo local se usar um gerenciador de conexões, porque um gerenciador de conexões de arquivos pode acessar só um arquivo. Para acessar vários arquivos locais, a tarefa FTP deve usar uma variável para fornecer as informações de caminho. Por exemplo, uma variável que contém "C:\Test\*.txt" fornece um caminho que dá suporte para excluir ou enviar todos os arquivos com uma extensão .txt no diretório Test.

Para enviar vários arquivos e acessar diversos arquivos locais e diretórios, você também pode executar diversas vezes a tarefa FTP incluindo a tarefa em um Loop Foreach. O Loop Foreach pode enumerar arquivos em um diretório usando o enumerador For Each File. Para obter mais informações, consulte Contêiner Loop Foreach.

A tarefa de FTP dá suporte para os caracteres curinga ? e * nos caminhos. Isso permite que a tarefa acesse vários arquivos. Porém, você só pode usar caracteres curinga na parte do caminho que especifica o nome de arquivo. Por exemplo, C:\MyDirectory\*.txt é um caminho válido, mas C:\*\MyText.txt não é.

Os operações de FTP podem ser configuradas para interromper a tarefa Sistema de Arquivos quando a operação falha ou para transferir arquivos no modo ASCII. As operações que enviam e recebem cópias de arquivos podem ser configuradas para substituir arquivos de destino e diretórios.

Operações de FTP predefinidas

A tarefa FTP inclui um conjunto predefinido de operações. A tabela a seguir descreve essas operações.

Operação Descrição
Enviar arquivos Envia um arquivo do computador local para o servidor FTP.
Receber arquivos Salva um arquivo do servidor FTP no computador local.
Criar diretório local Cria uma pasta no computador local.
Criar diretório remoto Cria uma pasta no servidor FTP.
Remover diretório local Exclui uma pasta no computador local.
Remover diretório remoto Exclui uma pasta no servidor FTP.
Excluir arquivos locais Exclui um arquivo no computador local.
Excluir arquivos remotos Exclui um arquivo no servidor FTP.

Entradas de log personalizadas disponíveis na tarefa FTP

A tabela a seguir relaciona as entradas de log personalizadas da tarefa FTP. Para obter mais informações, consulte Log do SSIS (Integration Services) e Mensagens personalizadas para registro em log.

Entrada de log Descrição
FTPConnectingToServer Indica que a tarefa iniciou uma conexão com o servidor FTP.
FTPOperation Informa o início e o tipo de operação de FTP que a tarefa executa.

Você pode definir propriedades pelo Designer do SSIS ou programaticamente.

Para obter informações sobre como definir essas propriedades no Designer do SSIS, confira Definir as propriedades de uma tarefa ou um contêiner.

Para obter mais informações sobre como definir essas propriedades de forma programática, consulte FtpTask.

Consulte Também

Editor da Tarefa FTP (página Geral)
Editor da Tarefa FTP (página Transferência de Arquivos)
Tarefas do Integration Services
Fluxo de Controle