Partilhar via


Tarefa FTP

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.

Observação importanteImportante

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 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 FTP dá suporte aos caracteres curinga ? e * em 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.

Outras tarefas relacionadas

O Integration Services inclui uma tarefa que executa operações em arquivos e diretórios no sistema de arquivos.

Para obter mais informações sobre essa tarefa, clique no seguinte tópico:

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 Implementando logs em pacotes 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.

Configurando a tarefa FTP

Você pode definir propriedades pelo Designer SSIS ou programaticamente.

Para obter mais informações sobre as propriedades que podem ser definidas no Designer do SSIS, clique em um dos seguintes tópicos:

Para obter mais informações sobre como definir essas propriedades no Designer SSIS, clique no seguinte tópico:

Configurando a tarefa FTP programaticamente

Para obter mais informações sobre como definir programaticamente essas propriedades, clique em um dos seguintes tópicos:

Ícone do Integration Services (pequeno) Fique atualizado com o Integration Services

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

Para receber uma notificação automática das atualizações, assine os feeds RSS disponíveis na página.