Lição 2-2: Adicionar e configurar o contentor Foreach Loop

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

Nesta tarefa, adiciona a capacidade de percorrer uma pasta de ficheiros planos e aplicar a transformação do fluxo de dados da Lição 1 a cada um desses ficheiros planos. Faz-se isto adicionando e configurando um contentor Foreach Loop ao fluxo de controlo.

O contentor Foreach Loop que adicionas deve conseguir ligar-se a cada ficheiro plano da pasta. Como todos os ficheiros na pasta têm o mesmo formato, o contentor Foreach Loop pode usar o mesmo gestor de ligação Flat File para se ligar a cada um destes ficheiros. O gestor de ligação de ficheiros planos que o contentor usa é o que criaste na Lição 1.

Atualmente, o gestor de ligações de ficheiros planos da Lição 1 liga-se apenas a um ficheiro plano específico. Para se ligar iterativamente a cada ficheiro plano na pasta, tem de configurar tanto o contentor Foreach Loop como o gestor de ligação Flat File da seguinte forma:

• Recipiente Foreach Loop: Mapeias o valor enumerado do contentor para uma variável de pacote definida pelo utilizador. O contentor usa então esta variável para modificar dinamicamente a propriedade ConnectionString do gestor de conexões Flat File e ligar-se iterativamente a cada ficheiro flat na pasta.

• Gestor de ligação de ficheiros planos: Modifica-se o gestor de conexões criado na Lição 1 usando uma variável definida pelo utilizador para preencher a propriedade ConnectionString do gestor de conexões.

Os procedimentos desta tarefa mostram-lhe como criar e modificar o contentor Foreach Loop para usar uma variável de pacote definida pelo utilizador e adicionar a tarefa de fluxo de dados ao ciclo. Vais aprender a modificar o gestor de ligações do Flat File para usar essa variável definida pelo utilizador na próxima tarefa.

Depois de fazeres estas modificações ao pacote, quando este é executado, o Foreach Loop Container percorre todos os ficheiros na pasta Sample Data. Cada vez que um ficheiro é encontrado que corresponde ao critério, o Foreach Loop Container preenche a nova variável com o nome do ficheiro, mapeia essa variável para a propriedade ConnectionString do gestor de conexões Sample Currency Data Flat File e depois executa o fluxo de dados contra esse ficheiro. Desta forma, em cada iteração do ciclo Foreach Loop, a tarefa Fluxo de Dados processa um ficheiro plano diferente.

Adicionar um contentor Foreach Loop

1. No SQL Server Data Tools, selecione o separador Fluxo de Controlo.

2. Na Caixa de Ferramentas do SSIS, expanda Contentores e, em seguida, arraste um Contentor de Ciclo Foreach para a superfície de estrutura do separador Fluxo de Controlo.

3. Clique com o botão direito no novo Foreach Loop Container e selecione Editar.

4. Na caixa de diálogo Foreach Loop Editor, na página Geral, em Nome, introduza Foreach File in Folder. Selecione OK.

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

Configure o enumerador para o contentor Foreach Loop

1. Clique duas vezes em Foreach File na Pasta para reabrir o Editor de Loops Foreach.

2. Selecionar a Coleção.

3. Na página Coleção, selecione Foreach File Enumerator.

4. No grupo de configuração do Enumerador , selecione Explorar.

5. Na caixa de diálogo Procurar Pasta , localize a pasta na sua máquina que contém os ficheiros Currency_*.txt incluídos com os dados de exemplo.

6. Na caixa Ficheiros , introduza Currency_*.txt.

Mapear o enumerador para uma variável definida pelo utilizador

1. Selecione Mapeamentos de Variáveis.

2. Na página de 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 , para Nome , introduza varNomeFicheiro.

   Note

   Os nomes das variáveis diferenciam maiúsculas de minúsculas.

4. Selecione OK.

5. Selecione OK novamente para sair do diálogo Foreach Loop Editor .

Adicionar a tarefa de fluxo de dados ao ciclo

• Arraste a tarefa de fluxo de dados Extrair Dados de Exemplo sobre Moeda para o contentor do ciclo Foreach Ficheiro na Pasta.

Passar para a próxima tarefa

Passo 3: Modificar o gestor de ligação Flat File

Conteúdo relacionado

• Contêiner de Ciclo Foreach
• Variáveis do Integration Services (SSIS)