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
No SQL Server Data Tools, selecione a guia Fluxo de Controle.
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 .
Clique com o botão direito do mouse no novo Contêiner Loop Foreach e selecione Editar.
Na caixa de diálogo Editor de Loop Foreach, na página Geral, em Nome, insira Arquivo Foreach na Pasta. Selecione OK.
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
Clique duas vezes em Arquivo Foreach na Pasta para abrir novamente o Editor de Loop Foreach.
Selecione Coleção.
Na página Coleção , selecione Enumerador de Arquivo Foreach.
No grupo Configuração do enumerador, selecione Procurar.
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.
Na caixa Arquivos, insira Currency_*.txt.
Mapear o enumerador para uma variável definida pelo usuário
Selecione Mapeamentos de Variáveis.
Na página Mapeamentos de Variáveis, na coluna Variável, selecione a célula vazia e selecione <Nova Variável...>.
Na caixa de diálogo Adicionar Variável, em Nome, digite varFileName.
Observação
Nomes de variáveis diferenciam maiúsculas e minúsculas.
Selecione OK.
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