Tarefa FTP

Artigo
05/07/2013

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 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, consulte Gerenciador de conexões de arquivos e Variáveis do SSIS (Integration Services).

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 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.

Tarefas relacionadas

Você pode definir propriedades por meio do SSIS Designer ou programaticamente.

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

Para obter mais informações sobre como definir essas propriedades programaticamente, consulte FtpTask.

Conteúdo relacionado

Mantenha-se atualizado com o Integration Services

Para obter os downloads, artigos, exemplos e vídeos mais recentes da Microsoft, bem como soluções selecionadas pela comunidade, visite a página Integration Services no MSDN: