Partilhar via

Tarefa do sistema de arquivos

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

A tarefa Sistema de arquivos executa operações em arquivos e diretórios no sistema de arquivos. Por exemplo, usando 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 ocultos ou somente leitura.

Todas as operações de tarefas do sistema de arquivos usam uma fonte, que pode ser um arquivo ou um diretório. Por exemplo, o arquivo que a tarefa copia ou o diretório que ela exclui é uma fonte. A origem pode ser especificada usando um gerenciador de conexões de arquivo 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, consulte Gerenciador de conexões de arquivo e variáveis do Integration Services (SSIS).

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 tarefas do sistema de arquivos podem ser configuradas para permitir a substituição de arquivos e diretórios de destino. A operação que cria um novo diretório pode ser configurada para usar um diretório existente que tenha o nome especificado em vez de falhar quando o diretório já existe.

Operações predefinidas do sistema de arquivos

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

Funcionamento Descrição
Copiar diretório Copia uma pasta de um local para outro.
Copiar ficheiro Copia um arquivo de um local para outro.
Criar um diretório Cria uma pasta em um local especificado.
Excluir diretório Exclui uma pasta em um local especificado.
Excluir conteúdo do diretório Exclui todos os arquivos e pastas em uma pasta.
Eliminar ficheiro Exclui um arquivo em um local especificado.
Mover diretório Move uma pasta de um local para outro.
Mover o ficheiro Move um arquivo de um local para outro.
Renomear arquivo Renomeia um arquivo em um local especificado.
Definir atributos Define atributos em arquivos e pastas. Os atributos incluem Archive, Hidden, Normal, ReadOnly e System. Normal é a falta de atributos, e não pode ser combinada com outros atributos. Todos os outros atributos podem ser usados em combinação.

A tarefa Sistema de arquivos opera em um único arquivo ou diretório. Portanto, essa tarefa não oferece suporte ao uso de caracteres curinga para executar a mesma operação em vários arquivos. Para que a tarefa Sistema de Arquivos repita uma operação em vários arquivos ou diretórios, coloque a tarefa Sistema de Arquivos em um contêiner de Loop Foreach, conforme descrito nas seguintes etapas:

  • Configurar o contentor Foreach Loop Na página Coleção do Editor de Loop Foreach, defina o enumerador como Foreach File Enumerator e insira a expressão curinga como a configuração do enumerador para Ficheiros. Na página Mapeamentos de Variáveis do Editor de Loop Foreach, mapeie uma variável que você deseja usar para passar os nomes de arquivo um de cada vez para a tarefa Sistema de Arquivos.

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

Entradas de registo personalizadas disponíveis na tarefa do sistema de ficheiros

A tabela a seguir descreve a entrada de log personalizada para a tarefa Sistema de arquivos. Para obter mais informações, consulte o Log de Serviços de Integração (SSIS) .

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

Configurando a tarefa do sistema de arquivos

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

Para obter mais informações sobre as propriedades que você pode definir no Designer SSIS, consulte os seguintes tópicos:

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

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

O Integration Services inclui uma tarefa que baixa e carrega arquivos de dados e gerencia diretórios em servidores. Para obter mais informações, consulte Tarefa FTP.

Editor de tarefas do sistema de arquivos (página Geral)

Use a página Geral da caixa de diálogo Editor de tarefas do sistema de arquivos para configurar a operação do sistema de arquivos executada pela tarefa.

Você deve especificar um gerenciador de conexões de origem e destino definindo as propriedades SourceConnection e DestinationConnection. Você pode fornecer os nomes dos gerenciadores de conexões de arquivo que apontam para os arquivos que a tarefa usa como origem ou destino ou, se os caminhos dos arquivos forem armazenados em variáveis, você pode fornecer os nomes das variáveis. Para usar variáveis para armazenar os caminhos de arquivo, você deve definir primeiro a opção IsSourcePathVariable para a conexão de origem e a opção IsDestinationPatheVariable para a conexão de destino como True. Em seguida, você pode escolher o sistema existente ou as variáveis definidas pelo usuário para usar, ou você pode criar novas variáveis. Na caixa de diálogo Adicionar variável , você pode configurar e especificar o escopo das variáveis. O escopo deve ser a tarefa Sistema de Arquivos ou um contêiner pai. Para obter mais informações, consulte Variáveis do Integration Services (SSIS) e Variáveis de uso em pacotes.

Observação

Para substituir as variáveis selecionadas para as propriedades SourceConnection e DestinationConnection , insira uma expressão para as propriedades Source e Destination . Insira expressões na página Expressões do Editor de tarefas do sistema de arquivos. Por exemplo, para definir o caminho dos arquivos que a tarefa usa como destino, convém usar a variável A sob determinadas condições e usar a variável B em outras condições.

Observação

A tarefa Sistema de arquivos opera em um único arquivo ou diretório. Portanto, essa tarefa não oferece suporte ao uso de caracteres curinga para executar a mesma operação em vários arquivos ou diretórios. Para que a tarefa Sistema de Arquivos repita uma operação em vários arquivos ou diretórios, coloque a tarefa Sistema de Arquivos em um contêiner de Loop Foreach. Para obter mais informações, consulte Tarefa do sistema de arquivos.

Você pode utilizar expressões para empregar variáveis diferentes para o

Opções

IsDestinationPathVariable
Indique se o caminho de destino está armazenado em uma variável. Esta propriedade tem as opções listadas na tabela a seguir.

Valor Descrição
Verdadeiro O caminho de destino é armazenado em uma variável. A seleção desse valor exibe a opção dinâmica, DestinationVariable.
Falso O caminho de destino é especificado em um gerenciador de conexões de arquivo. Selecionar esse valor exibe a opção dinâmica, DestinationConnection.

OverwriteDestination
Especifique se a operação pode substituir arquivos no diretório de destino.

Nome
Forneça um nome exclusivo para a tarefa Sistema de arquivos. 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
Digite uma descrição da tarefa Sistema de ficheiros.

Funcionamento
Selecione a operação do sistema de arquivos a ser executada. Esta propriedade tem as opções listadas na tabela a seguir.

Valor Descrição
Copiar diretório Copiar o diretório. A seleção desse valor exibe as opções dinâmicas para uma origem e um destino.
Copiar ficheiro Copie um arquivo. A seleção desse valor exibe as opções dinâmicas para uma origem e um destino.
Criar diretório Crie um diretório. A seleção desse valor exibe as opções dinâmicas para um diretório de origem e um diretório de destino.
Excluir diretório Exclua um diretório. A seleção desse valor exibe as opções dinâmicas de uma fonte.
Excluir conteúdo do diretório Exclua o conteúdo de um diretório. A seleção desse valor exibe as opções dinâmicas de uma fonte.
Eliminar ficheiro Exclua um arquivo. A seleção desse valor exibe as opções dinâmicas de uma fonte.
Mover diretório Mover um diretório. A seleção desse valor exibe as opções dinâmicas para uma origem e um destino.
Mover arquivo Mova um arquivo. A seleção desse valor exibe as opções dinâmicas para uma origem e um destino. Ao mover um arquivo, não inclua um nome de arquivo no caminho do diretório fornecido como destino.
Renomear arquivo Renomeie um arquivo. A seleção desse valor exibe as opções dinâmicas para uma origem e um destino. Ao renomear um arquivo, inclua o novo nome de arquivo no caminho de diretório fornecido para o destino.
Definir atributos Defina os atributos de um arquivo ou diretório. A seleção desse valor exibe as opções dinâmicas para uma origem e operação.

IsSourcePathVariable
Indique se o caminho de destino está armazenado em uma variável. Esta propriedade tem as opções listadas na tabela a seguir.

Valor Descrição
Verdadeiro O caminho de destino é armazenado em uma variável. A seleção desse valor exibe a opção dinâmica, SourceVariable.
Falso O caminho de destino é especificado em um gerenciador de conexões de arquivo. A seleção desse valor exibe a opção dinâmica, DestinationVariable.

Opções dinâmicas IsDestinationPathVariable

IsDestinationPathVariable = Verdadeiro

DestinationVariable
Selecione o nome da variável na lista ou clique em <Nova variável...> para criar uma nova variável.

Tópicos relacionados:variáveis do Integration Services (SSIS)Adicionar variável

IsDestinationPathVariable = Falso

DestinationConnection
Selecione um gerenciador de conexões de arquivo na lista ou clique em <Nova conexão...> para criar um novo gerenciador de conexões.

Tópicos relacionados:Gerenciador de Conexão de Ficheiros, Editor de Gerenciador de Conexão de Ficheiros

IsSourcePathVariable Opções Dinâmicas

IsSourcePathVariable = Verdadeiro

SourceVariable
Selecione o nome da variável na lista ou clique em <Nova variável...> para criar uma nova variável.

Tópicos relacionados:variáveis do Integration Services (SSIS)Adicionar variável

IsSourcePathVariable = Falso

SourceConnection
Selecione um gerenciador de conexões de arquivo na lista ou clique em <Nova conexão...> para criar um novo gerenciador de conexões.

Tópicos relacionados:Gestor de Conexão de Ficheiros

Opções dinâmicas de operação

Operação = Definir atributos

Escondido
Indique se o arquivo ou diretório está visível.

Apenas leitura
Indique se o ficheiro é só de leitura.

Arquivo
Indique se o arquivo ou diretório está pronto para arquivamento.

Sistema
Indique se o ficheiro é um ficheiro do sistema operativo.

Operação = Criar diretório

UseDirectoryIfExists
Indica se a operação Criar diretório usa um diretório existente com o nome especificado em vez de criar um novo diretório.

Ver também

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

  • Last updated on