Compartilhar via


Tarefa Sistema de Arquivos

A tarefa Sistema de Arquivos executa operações em arquivos e diretórios no sistema de arquivos. Por exemplo, ao usar a tarefa Sistema de Arquivos, um pacote pode criar, mover ou excluir diretórios e arquivos. Você também pode usar a tarefa Sistema de Arquivos para definir atributos em arquivos e diretórios. Por exemplo, a tarefa Sistema de Arquivos pode tornar os arquivos em ocultos ou somente leitura.

Todas as operações da tarefa Sistema de Arquivos usam uma origem, que pode ser um arquivo ou diretório. Por exemplo, o arquivo que a tarefa copia ou o diretório que ela exclui é uma origem. A origem pode ser especificada usando um gerenciador de conexões de arquivos que aponta para o diretório ou arquivo, ou fornecendo o nome de uma variável que contém o caminho de origem. Para obter mais informações, confira Gerenciador de Conexões de Arquivos e Variáveis do SSIS (Integration Services).

As operações que copiam e movem arquivos e diretórios e renomeiam arquivos usam um destino e uma origem. O destino é especificado usando um gerenciador de conexões de arquivo ou uma variável. As operações de tarefa do sistema de arquivos podem ser configuradas para permitir substituição de arquivos de destino e os diretórios. A operação que cria um diretório novo pode ser configurada para usar um diretório existente que tenha o nome especificado, em vez de haver uma falha quando já existir o diretório.

Operações do sistema de arquivos predefinidas

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

Operação Descrição
Copiar diretório Copia uma pasta de um local para outro.
Copiar arquivo Copia um arquivo de um local para outro.
Criar diretório Cria uma pasta em um local especificado.
Excluir diretório Exclui uma pasta de um local especificado.
Excluir conteúdo do diretório Exclui todos os arquivos e pastas de uma pasta.
Excluir arquivo Exclui um arquivo de um local especificado.
Mover diretório Move uma pasta de um local para outro.
Mover arquivo Move um arquivo de um local para outro.
Renomear arquivo Renomeia um arquivo em um local especificado.
Definir atributos Define os atributos de arquivos e pastas. Os atributos incluem: Arquivo morto, Oculto, Normal, Somente Leitura e Sistema. Normal é a falta de atributos e não pode ser combinado com outros atributos. Todos os outros atributos podem ser usados em combinação.

A tarefa Sistema de Arquivos funciona em um único arquivo ou diretório. Por isso, essa tarefa não dá suporte a uso de caracteres curingas para executar a mesma operação em vários arquivos. Para fazer uma tarefa Sistema de Arquivos repetir uma operação em vários arquivos ou diretórios, coloque a tarefa Sistema de Arquivos em um contêiner Loop Foreach, conforme descrito nas seguintes etapas:

  • Configurar o contêiner Loop Foreach Na página Coleção do Editor de Loop Foreach, defina o enumerador como Enumerador de Arquivo Foreach e digite a expressão de caractere curinga, conforme a configuração do enumerador para Arquivos. Na página Mapeamento de Variáveis do Editor de Loop Foreach, mapeie uma variável que você deseja usar para passar os nomes de arquivos, um de cada vez, para a tarefa Sistema de Arquivos.

  • Adicionar e configurar uma tarefa Sistema de Arquivos Adicionar uma tarefa Sistema de Arquivos ao contêiner Loop Foreach. Na página Geral do Editor da Tarefa Sistema de Arquivos, defina o SourceVariable ou a propriedade DestinationVariable para a variável que você definiu no contêiner Loop Foreach.

Entradas de log personalizadas disponíveis na tarefa Sistema de Arquivos

A tabela a seguir descreve a entrada de log personalizada da tarefa Sistema de Arquivos. Para obter mais informações, consulte Log do SSIS (Integration Services) e Mensagens personalizadas para registro em log.

Entrada de log Descrição
FileSystemOperation Informa a operação executada pela tarefa. A entrada de log é gravada quando a operação de sistema de arquivos é iniciada e inclui informações sobre a origem e o destino.

Configurando a tarefa Arquivo de Sistemas

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

Para obter mais informações sobre as propriedades que podem ser definidas no SSIS Designer, consulte os tópicos a seguir:

Para obter mais informações sobre como definir essas propriedades no SSIS Designer, consulte o tópico a seguir:

Para obter mais informações sobre como definir essas propriedades programaticamente, consulte o tópico a seguir:

Integration Services inclui uma tarefa que faz downloads e uploads de arquivos de dados e gerencia diretórios em servidores. Para obter mais informações, consulte FTP Task.

Consulte Também

Tarefas do Integration Services
Fluxo de Controle