Partilhar via

Tarefa FTP

Aplica-se a:SQL Server SSIS Integration Runtime em Azure Data Factory

A tarefa FTP descarrega e carrega ficheiros de dados e gere diretórios nos servidores. Por exemplo, um pacote pode descarregar ficheiros de dados de um servidor remoto ou de uma localização na Internet como parte de um fluxo de trabalho de um pacote de Serviços de Integração. Pode usar a tarefa FTP para os seguintes fins:

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

  • Iniciar sessão numa localização FTP de origem e copiar ficheiros ou pacotes para um diretório de destino.

  • Descarregar ficheiros a partir de uma localização FTP e aplicar transformações aos dados das colunas antes de os carregar numa base de dados.

Em tempo de execução, a tarefa FTP liga-se a um servidor através de um gestor de ligações FTP. O gestor de ligação FTP é configurado separadamente da tarefa FTP e depois é referenciado na tarefa FTP. O gestor de ligações FTP inclui as definições do servidor, as credenciais para aceder ao servidor FTP e opções como o time-out e o número de tentativas de ligação ao servidor. Para mais informações, consulte FTP Connection Manager.

Importante

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

Ao aceder a um ficheiro local ou a um diretório local, a tarefa FTP utiliza um gestor de ligação de ficheiros ou informação de caminho armazenada numa variável. Em contraste, ao aceder a um ficheiro remoto ou a um diretório remoto, a tarefa FTP utiliza um caminho diretamente especificado no servidor remoto, conforme especificado no gestor de conexões FTP, ou informação de caminho armazenada numa variável. Para obter mais informações, consulte Gerenciador de conexões de arquivo e variáveis do Integration Services (SSIS).

Isto significa que a tarefa FTP pode receber múltiplos ficheiros e eliminar vários ficheiros remotos; mas a tarefa pode enviar apenas um ficheiro e eliminar apenas um ficheiro local se usar um gestor de conexões, porque um gestor de ligações de ficheiros só pode aceder a um ficheiro. Para aceder a múltiplos ficheiros locais, a tarefa FTP deve usar uma variável para fornecer a informação do caminho. Por exemplo, uma variável que contém "C:\Test*.txt" fornece um caminho que suporta a eliminação ou envio de todos os ficheiros que tenham uma extensão .txt no diretório de Test.

Para enviar múltiplos ficheiros e aceder a vários ficheiros e diretórios locais, pode também executar a tarefa FTP várias vezes, incluindo a tarefa num ciclo Foreach. O Loop Foreach pode enumerar entre ficheiros num diretório usando o enumerador For Each File. Para obter mais informações, consulte Foreach Loop Container.

A tarefa FTP suporta os caracteres curinga '?' e '*' nos caminhos. Isto permite que a tarefa aceda a múltiplos ficheiros. No entanto, só pode usar caracteres coringa na parte do caminho que especifica o nome do ficheiro. Por exemplo, C:\MyDirectory\*.txt é um caminho válido, mas C:\*\MyText.txt não é.

As operações FTP podem ser configuradas para parar a tarefa do Sistema de Ficheiros quando a operação falha, ou para transferir ficheiros em modo ASCII. As operações que enviam e recebem ficheiros podem ser configuradas para sobrescrever ficheiros e diretórios de destino.

Operações FTP pré-definidas

A tarefa FTP inclui um conjunto pré-definido de operações. A tabela a seguir descreve essas operações.

Funcionamento Description
Enviar ficheiros Envia um ficheiro do computador local para o servidor FTP.
Receber ficheiros Guarda um ficheiro do servidor FTP para o 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 Apaga uma pasta no computador local.
Remover diretório remoto Apaga uma pasta no servidor FTP.
Eliminar ficheiros locais Apaga um ficheiro do computador local.
Eliminar ficheiros remotos Apaga um ficheiro no servidor FTP.

Entradas de registo personalizadas disponíveis na tarefa FTP

A tabela seguinte lista as entradas de registo personalizadas para a tarefa FTP. Para obter mais informações, consulte o Log de Serviços de Integração (SSIS) .

Entrada de log Description
FTPConnectingToServer Indica que a tarefa iniciou uma ligação ao servidor FTP.
FTPOperação Reporta o início e o tipo de operação FTP que a tarefa realiza.

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

Para informações sobre como definir estas propriedades no SSIS Designer, veja Definir as Propriedades de uma Tarefa ou Contentor.

Para mais informações sobre como definir programaticamente estas propriedades, veja FtpTask.

Editor de Tarefas FTP (Página Geral)

Use a página Geral da caixa de diálogo do Editor de Tarefas FTP para especificar o gestor de ligações FTP que se liga ao servidor FTP com o qual a tarefa comunica. Também pode nomear e descrever a tarefa FTP.

Opções

FtpConnection
Seleciona um gestor de ligações FTP existente, ou clica <em Nova ligação...> para criar um gestor de ligações.

Importante

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

Tópicos Relacionados: Gestor de Ligações FTP, Editor do Gestor de Ligações FTP

StopOnFailure
Indique se a tarefa FTP termina se uma operação FTP falhar.

Nome
Forneça um nome único para a tarefa FTP. Esse nome é usado como o rótulo no ícone da tarefa.

Observação

Os nomes das tarefas devem ser exclusivos dentro de um pacote.

Descrição
Escreva uma descrição da tarefa FTP.

Editor de Tarefas FTP (Página de Transferência de Ficheiros)

Use a página de Transferência de Ficheiros da caixa de diálogo do Editor de Tarefas FTP para configurar a operação FTP que a tarefa realiza.

Opções

IsRemotePathVariable
Indique se o caminho remoto está armazenado numa variável. Esta propriedade tem as opções listadas na tabela a seguir.

Valor Description
Verdadeiro O caminho de destino é armazenado em uma variável. Ao selecionar o valor, apresenta-se a opção dinâmica, RemoteVariable.
Falso O caminho de destino é especificado em um gerenciador de conexões de arquivo. Ao selecionar o valor, mostra a opção dinâmica, RemotePath.

OverwriteFileAtDestination
Especifique se um ficheiro no destino pode ser sobrescrevido.

IsLocalPathVariable
Indique se o caminho local está armazenado numa variável. Esta propriedade tem as opções listadas na tabela a seguir.

Valor Description
Verdadeiro O caminho de destino é armazenado em uma variável. Ao selecionar o valor, apresenta-se a opção dinâmica, LocalVariable.
Falso O caminho de destino é especificado em um gerenciador de conexões de arquivo. Ao selecionar o valor, apresenta-se a opção dinâmica, LocalPath.

Operation
Selecione a operação FTP a realizar. Esta propriedade tem as opções listadas na tabela a seguir.

Valor Description
Enviar ficheiros Enviar ficheiros. Ao selecionar este valor, apresenta-se as opções dinâmicas, LocalVariable, LocalPathRemoteVariable e RemotePath.
Receber ficheiros Receber ficheiros. Ao selecionar este valor, apresenta-se as opções dinâmicas, LocalVariable, LocalPathRemoteVariable e RemotePath.
Criar diretório local Crie um diretório local. Ao selecionar este valor, apresenta-se as opções dinâmicas, LocalVariable e LocalPath.
Criar diretório remoto Crie um diretório remoto. Ao selecionar este valor, apresenta-se as opções dinâmicas, RemoteVariable e RemotePath.
Remover diretório local Remove um diretório local. Ao selecionar este valor, apresenta-se as opções dinâmicas, LocalVariable e LocalPath.
Remover diretório remoto Remover um diretório remoto. Ao selecionar este valor, apresenta-se as opções dinâmicas, RemoteVariable e RemotePath.
Eliminar ficheiros locais Apagar ficheiros locais. Ao selecionar este valor, apresenta-se as opções dinâmicas, LocalVariable e LocalPath.
Eliminar ficheiros remotos Apagar ficheiros remotos. Ao selecionar este valor, apresenta-se as opções dinâmicas, RemoteVariable e RemotePath.

IsTransferASCII
Indique se os ficheiros transferidos para e do servidor FTP remoto devem ser transferidos em modo ASCII.

Opções Dinâmicas de IsRemotePathVariable

IsRemotePathVariable = Verdadeiro

RemoteVariable
Selecione uma variável definida pelo utilizador existente, ou clique em <Nova variável...> para criar uma variável definida pelo utilizador.

Tópicos Relacionados:Variáveis de Serviços de Integração (SSIS), Adicionar Variável

IsRemotePathVariable = False

RemotePath
Seleciona um gestor de ligações FTP existente, ou clica <em Nova ligação...> para criar um gestor de ligações.

Tópicos Relacionados:Gestor de Ligações FTP, Editor do Gestor de Ligações FTP

IsLocalPathVariable Opções Dinâmicas

IsLocalPathVariable = True

LocalVariable
Selecione uma variável definida pelo utilizador existente, ou clique em <Nova variável...> para criar uma variável.

Tópicos Relacionados:Variáveis de Serviços de Integração (SSIS), Adicionar Variável

IsLocalPathVariable = Falso

LocalPath
Selecione um gestor de ligações de ficheiros existente, ou clique em <Nova ligação...> para criar um gestor de ligações.

Tópicos Relacionados: Gestor de Ligação de Ficheiros Planos

Ver também

Tarefas dos Serviços de Integração
Controle de Fluxo

  • Last updated on