Compartilhar via


Lição 2-2: Adicionar e configurar o contêiner Loop Foreach

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

Nessa tarefa, você adicionará a capacidade de executar loop através de uma pasta de arquivos simples e aplicará a transformação de fluxo de dados da Lição 1 a cada um desses arquivos simples. Você faz isto adicionando e configurando um contêiner Loop Foreach ao fluxo de controle.

O contêiner Loop Foreach que você adicionar deve ser capaz de se conectar a cada arquivo simples na pasta. Como todos os arquivos da pasta têm o mesmo formato, o contêiner Loop Foreach pode usar o mesmo gerenciador de conexões de Arquivo Simples para conectar-se a cada um desses arquivos. O gerenciador de conexão do Arquivo Simples que o contêiner usa é o que você criou na Lição 1.

Atualmente, o gerenciador de conexões de Arquivo Simples da Lição 1 se conecta a um único arquivo simples específico. Para conectar-se iterativamente a cada arquivo simples da pasta, é preciso configurar o contêiner Loop Foreach e o gerenciador de conexões de Arquivo Simples da seguinte maneira:

  • Contêiner do Loop Foreach: Mapeie o valor enumerado do contêiner para uma variável de pacote definida pelo usuário. O contêiner usará essa variável para modificar dinamicamente a propriedade ConnectionString do gerenciador de conexões de Arquivo Simples e conectar-se de forma iterativa a cada um dos arquivos simples da pasta.

  • Gerenciador de conexões de Arquivo Simples: Modifique o gerenciador de conexões criado na Lição 1 usando uma variável definida pelo usuário para popular a propriedade ConnectionString do gerenciador de conexões.

Os procedimentos nessa tarefa mostram como você pode criar e modificar o contêiner Loop Foreach para usar uma variável definida pelo usuário e adicionar a tarefa de fluxo de dados ao loop. Você aprenderá como modificar o gerenciador de conexões de Arquivo Simples para usar a variável definida pelo usuário na próxima tarefa.

Após essas modificações no pacote, quando ele for executado, o contêiner Loop Foreach iterará através de todos os arquivos na pasta Dados de Exemplo. Sempre que um arquivo que corresponda aos critérios for encontrado, o contêiner Loop Foreach preencherá a nova variável com o nome do arquivo, mapeará essa variável para a propriedade ConnectionString do gerenciador de conexões de Arquivo Simples dos Dados de Moeda de Exemplo e executará o fluxo de dados nesse arquivo. Dessa forma, em cada iteração do Loop Foreach a tarefa de Fluxo de Dados consumirá um arquivo simples diferente.

Observação

Como o Microsoft Integration Services separa o fluxo de controle do fluxo de dados, qualquer loop que você adicionar ao fluxo de controle não exigirá modificações no fluxo de dados. Portanto, o fluxo de dados da Lição 1 não precisará ser alterado.

Adicionar um contêiner Loop Foreach

  1. No SQL Server Data Tools, selecione a guia Fluxo de Controle.

  2. Na Caixa de Ferramentas do SSIS, expanda Contêinerese arraste um Contêiner Loop Foreach até a superfície de design da guia Fluxo de Controle .

  3. Clique com o botão direito do mouse no novo Contêiner Loop Foreach e selecione Editar.

  4. Na caixa de diálogo Editor de Loop Foreach, na página Geral, em Nome, insira Arquivo Foreach na Pasta. Selecione OK.

  5. Clique com o botão direito do mouse no contêiner Loop Foreach, selecione Propriedades e, na janela Propriedades, verifique se a propriedade LocaleID está definida como Inglês (Estados Unidos) .

Configurar o enumerador para o contêiner Loop Foreach

  1. Clique duas vezes em Arquivo Foreach na Pasta para abrir novamente o Editor de Loop Foreach.

  2. Selecione Coleção.

  3. Na página Coleção , selecione Enumerador de Arquivo Foreach.

  4. No grupo Configuração do enumerador, selecione Procurar.

  5. Na caixa de diálogo Procurar pasta, localize a pasta no computador que contém os arquivos Currency_*.txt incluídos nos dados de exemplo.

  6. Na caixa Arquivos, insira Currency_*.txt.

Mapear o enumerador para uma variável definida pelo usuário

  1. Selecione Mapeamentos de Variáveis.

  2. Na página Mapeamentos de Variáveis, na coluna Variável, selecione a célula vazia e selecione <Nova Variável...>.

  3. Na caixa de diálogo Adicionar Variável, em Nome, digite varFileName.

    Observação

    Nomes de variáveis diferenciam maiúsculas e minúsculas.

  4. Selecione OK.

  5. Selecione OK novamente para sair da caixa de diálogo Editor de Loop Foreach.

Adicionar a tarefa de fluxo de dados ao loop

  • Arraste a tarefa de fluxo de dados Extrair Dados de Moeda de Exemplo até o contêiner Loop Foreach Arquivo Foreach na Pasta.

Ir para a próxima tarefa

Etapa 3: Modificar o gerenciador de conexões de Arquivo Simples

Confira também

Configurar um contêiner Loop Foreach
Usar variáveis em pacotes