Tutorial do SQL Server 2008 Integration Services

Sumrio
Tutorial: Criando um pacote ETL simples .............................................................................. 3 Lio 1: Criando o projeto e pacote bsico ............................................................................ 5 Tarefa 1: Criando um novo projeto do Integration Services ............................................ 7 Tarefa 2: Adicionando e configurando um gerenciador de conexes de arquivo simples ..................................................................................................................................... 8 Tarefa 3: Adicionando e configurando um gerenciador de conexes OLE DB .......... 11 Tarefa 4: Adicionando uma tarefa de fluxo de dados ao pacote .................................. 12 Tarefa 5: Adicionando e configurando a fonte de arquivo simples............................... 13 Tarefa 6: Adicionando e configurando a transformao Pesquisa ............................... 14 Tarefa 7: Adicionando e configurando o destino OLE DB ............................................. 16 Tarefa 8: Tornando o pacote da Lio 1 mais fcil de compreender ........................... 17 Tarefa 9: Testando o pacote de tutorial da Lio 1......................................................... 18 Lio 2: Adicionando loop ....................................................................................................... 19 Tarefa 1: Copiando o pacote da Lio 1........................................................................... 20 Tarefa 2: Adicionando e configurando o continer Loop Foreach ................................ 21 Tarefa 3: Modificando o Gerenciador de Conexes de Arquivo Simples .................... 23 Tarefa 4: Testando o pacote de tutorial da Lio 2......................................................... 24 Lio 3: Adicionando configuraes de pacote ................................................................... 26 Tarefa 1: Copiando o pacote da Lio 2........................................................................... 27 Tarefa 2: Configurando e habilitando configuraes de pacote ................................... 28 Tarefa 3: Modificando o Gerenciador de Conexes de Arquivo Simples .................... 30 Tarefa 4: Testando o pacote de tutorial da Lio 3......................................................... 31 Lio 4: Adicionando log ......................................................................................................... 32 Tarefa 1: Copiando o pacote da Lio 3........................................................................... 33 Tarefa 2: Adicionando e configurando registro em log ................................................... 35 Tarefa 3: Testando o pacote de tutorial da Lio 4......................................................... 36 Lio 5: Adicionando redirecionamento de fluxo de erro ................................................... 38 Tarefa 1: Copiando o pacote da Lio 4........................................................................... 39 Tarefa 2: Criando um arquivo corrompido ........................................................................ 40 Tarefa 3: Adicionando redirecionamento de fluxo de erro ............................................. 41 Tarefa 4: Adicionando um destino de arquivo simples ................................................... 43 Tarefa 5: Testando o pacote de tutorial da Lio 5......................................................... 45

Tutorial: Criando um pacote ETL simples

Microsoft Integration Services uma plataforma para criar solues de integrao de dados de alto desempenho, incluindo pacotes de extrao, transformao e carregamento (ETL) para o armazenamento de dados. O Integration Services inclui ferramentas grficas e assistentes para criao e depurao de pacotes; tarefas para execuo de funes de fluxo de trabalho, como operaes de FTP, execuo de instrues SQL, envio de mensagens de email, fontes de dados e destinos para a extrao e o carregamento de dados, transformaes para limpeza, agregao, intercalao e cpia de dados, alm dos servios de administrao, Integration Services para administrar a execuo e o armazenamento de pacote, bem como interfaces de programao de aplicativos (APIs) para a programao do modelo de objeto Integration Services. Neste tutorial, voc aprender a usar o SSIS Designer para criar um pacote simples do Microsoft SQL Server Integration Services. O pacote que voc cria conduz dados de um arquivo simples, formata esses dados e insere os dados formatados em uma tabela de fatos. Nas lies a seguir, o pacote ser expandido para demonstrar looping, configuraes de pacote, registro de log e fluxo de erros. Ao instalar os dados de exemplo usados pelo tutorial, as verses concludas dos pacotes criados para cada lio do tutorial tambm so instaladas. Ao utilizar os pacotes concludos, ser possvel comear o tutorial em uma lio posterior, caso queira. Se esta for a primeira vez que voc trabalha com pacotes ou com o novo ambiente de desenvolvimento, recomendamos que voc comece pela lio 1. O que voc aprender

O melhor modo de familiarizar-se com as novas ferramentas, controles e recursos disponveis no Microsoft SQL Server Integration Services utilizando-os. Este tutorial explicar como usar o Designer de SSIS para criar um pacote de ETL simples com looping, configuraes, lgica de fluxo de erros e registro de logs. Requisitos

O tutorial destinado a usurios familiarizados com operaes bsicas de banco de dados, mas que tiveram pouca experincia com os novos recursos disponveis no SQL Server Integration Services. Para que voc possa usar este tutorial, os seguintes componentes devem estar instalados no sistema: SQL Server com o banco de dados AdventureWorksDW. Este tutorial tambm requer dados de exemplo. Os dados de exemplo so instalados junto com as amostras.

Este tutorial assume que voc no reconfigurou o Designer de SSIS para usar os recursos de conexo automtica entre os elementos de fluxo de controle ou de fluxo de dados. Caso o Designer de SSIS use a conexo automtica, um elemento poder ser conectado automaticamente quando adicionado superfcie de design. Alm disso, o recurso de conexo automtica para o fluxo de controle oferece suporte ao uso de Falha e Concluso como restrio padro, em vez de xito. Caso o Designer de SSIS no use a opo xito como restrio padro, defina novamente essa configurao durante o uso do tutorial. Configure os recursos de conexo automtica na seo Designers do Business Intelligence na caixa de dilogo Opes que est disponvel em Opes no menu Ferramenta. Lies neste tutorial

Lio 1: Criando o projeto e pacote bsico Nesta lio, voc criar um pacote de ETL simples que extrair dados de um arquivo simples, transformar os dados usando transformaes de pesquisa e, por fim, carregar o resultado em um destino da tabela de fatos. Lio 2: Adicionando loop Nesta lio, voc expandir o pacote criado na lio 1 para obter as vantagens dos novos recursos de looping a fim de extrair vrios arquivos simples em apenas um processo de fluxo de dados. Lio 3: Adicionando configuraes de pacote Nesta lio, voc expandir o pacote criado na lio 2 para usar as novas opes de configurao de pacote. Lio 4: Adicionando log Nesta lio, voc expandir o pacote criado na lio 3 para usar as novas opes de registro de logs. Lio 5: Adicionando redirecionamento de fluxo de erro Nesta lio, voc expandir o pacote criado na lio 4 para usar as novas opes de configurao das sadas de erro.

Lio 1: Criando o projeto e pacote bsico

Nessa lio, voc criar um pacote ETL simples que extrai dados de uma fonte exclusiva de arquivo simples, transforma os dados usando dois componentes de transformao pesquisa e grava estes dados na tabela de fatos FactCurrencyRate no AdventureWorksDW. Como parte dessa lio, voc ir aprender como criar novos pacotes, adicionar e configurar fonte de dados, e conexes de destino, e trabalhar com novos fluxos de controle e componentes de fluxo. Compreendendo os requisitos de pacote

Antes de criar um pacote, voc precisa ter um bom conhecimento da formatao usada tanto na fonte de dados quanto no destino. Depois de entender estes dois formatos de dados, voc estar pronto para definir as transformaes necessrias para mapear a fonte de dados ao destino. Olhando para a Fonte Nesse tutorial, os dados de origem so um conjunto de dados de moeda corrente histricos contidos no arquivo simples, SampleCurrencyData.txt. A fonte de dados tem as quatro colunas a seguir: a taxa mdia da moeda, um cdigo de moeda, um cdigo de data e a taxa do fim do dia. Aqui est um exemplo dos dados de origem contidos no arquivo SampleCurrencyData.txt: 1.00010001 ARS 9/3/2001 0:00 1.00010001 ARS 9/4/2001 0:00 1.00020004 ARS 9/5/2001 0:00 1.00020004 ARS 9/6/2001 0:00 1.00050025 ARS 9/7/2001 0:00 1.00050025 ARS 9/8/2001 0:00 1.00050025 ARS 9/9/2001 0:00 0.99960016 1.001001001 0.99990001 1.00040016 0.99990001 1.001001001 1

1.00010001 ARS 9/10/2001 0:00 1.00040016 1.00020004 ARS 9/11/2001 0:00 0.99990001 1.00020004 ARS 9/12/2001 0:00 1.001101211

Quando estiver trabalhando com dados de fonte de arquivo simples, importante entender como o gerenciador de conexes de Arquivo Simples interpreta os dados de arquivo simples. Se a fonte do arquivo simples for Unicode, o gerenciador de conexes de Arquivo Simples definir todas as colunas como [DT_WSTR] com uma largura padro de coluna de 50. Se a fonte de arquivo simples for codificada por ANSI, as colunas estaro definidas como [DT_STR] com uma largura de coluna de 50. Voc provavelmente ter que alterar esses padres para tornar os tipos de coluna de cadeia de caracteres mais apropriados para seus dados. Para

fazer isso, voc precisar olhar o tipo de dados do destino onde os dados sero gravados, e, ento, escolher o tipo correto dentro do gerenciador de conexes de Arquivo Simples. Olhando o destino O destino final para a fonte de dados a tabela de fatos FactCurrencyRate no AdventureWorksDW. A tabela de fatos FactCurrencyRate tem quatro colunas, e tem relaes com duas tabelas dimensionais, como mostrado na tabela a seguir. Nome da coluna AverageRate CurrencyKey TimeKey Tipo de dados float int (FK) Int (FK) Tabela de pesquisa Nenhum DimCurrency DimTime Coluna de pesquisa Nenhum CurrencyKey (PK) TimeKey (PK) Nenhum

EndOfDayRate float Nenhum Mapeando fontes de dados compatveis com o destino

Uma anlise dos dados de fonte e destino indicam que as pesquisas sero necessrias para os valores CurrencyKey e TimeKey . As transformaes que iro executar essas pesquisas iro obter os valoresCurrencyKey e TimeKey usando as chaves alternadas das tabelas dimensionais DimCurrency e DimTime . Coluna de arquivo simples 0 1 2 3 Nome da Tabela FactCurrencyRate DimCurrency DimTime FactCurrencyRate Nome da coluna AverageRate CurrencyAlternateKey FullDateAlternateKey EndOfDayRate

Tarefas da lio

Esta lio contm as seguintes tarefas: Tarefa 1: Criando um novo projeto do Integration Services Tarefa 2: Adicionando e configurando um gerenciador de conexes de arquivo simples Tarefa 3: Adicionando e configurando um gerenciador de conexes OLE DB Tarefa 4: Adicionando uma tarefa de fluxo de dados ao pacote Tarefa 5: Adicionando e configurando a fonte de arquivo simples Tarefa 6: Adicionando e configurando a transformao Pesquisa Tarefa 7: Adicionando e configurando o destino OLE DB Tarefa 8: Tornando o pacote da Lio 1 mais fcil de compreender Tarefa 9: Testando o pacote de tutorial da Lio 1

Tarefa 1: Criando um novo projeto do Integration Services

A primeira tarefa da criao de um pacote no Integration Services criar um projeto do Integration Services. Esse projeto inclui modelos para objetos fontes de dados, exibies de fontes de dados e pacotes usados em uma soluo de transformao. Os pacotes que sero criados neste tutorial do Integration Services interpretam os valores de dados com distino de localidade. Se o seu computador no estiver configurado para usar a opo regional Ingls (Estados Unidos), ser preciso definir propriedades adicionais no pacote. Os pacotes usados nas lies 2 a 5 sero copiados a partir do pacote criado na lio 1 e no ser preciso atualizar as propriedades que fazem distino de localidade nos pacotes copiados. Para criar um novo projeto Integration Services

1. No menu Iniciar, aponte para Todos os Programas, Microsoft SQL Server e clique em SQL ServerBusiness Intelligence Development Studio. 2. No menu Arquivo, aponte para Novo e clique em Projeto para criar um novo projeto Integration Services. 3. Na caixa de dilogo Novo Projeto, selecione Projeto do Integration Services no painel Modelos. 4. Na caixa Nome, altere o nome padro para Tutorial SSIS. Opcionalmente, desmarque a caixa de seleo Criar diretrio para a soluo. 5. Aceite o local padro ou clique em Procurar para procurar pela pasta que deseja usar. 6. Na caixa de dilogo Local do Projeto, clique na pasta e clique em Abrir. 7. Clique em OK. Por padro, um pacote vazio chamado Package.dtsx ser criado e adicionado ao seu projeto. 8. Na barra de ferramentas do Gerenciador de Solues, clique com o boto direito em Package.dtsx, escolha Renomear e renomeie o pacote padro para Lio 1.dtsx. 9. Quando o sistema perguntar sobre a renomeao do objeto de pacote, clique em Sim. Definir propriedades com distino de localidade

1. No menu Exibir, clique em Janela de Propriedades. 2. Na janela Propriedades, defina a propriedade LocaleID como Ingls (Estados Unidos).

Tarefa 2: Adicionando e configurando um gerenciador de conexes de arquivo simples

Nesta tarefa, voc adiciona um gerenciador de conexes de Arquivos Simples ao pacote que acabou de criar. Um gerenciador de conexes de Arquivos Simples habilita um pacote para extrair dados de um arquivo simples. Com o gerenciador de conexes de Arquivos Simples, voc pode especificar o nome e o local do arquivo, a localidade e a pgina de cdigos e o formato do arquivo, incluindo os delimitadores de coluna, a serem aplicados quando o pacote extrai os dados do arquivo simples. Alm disso, possvel especificar manualmente o tipo de dados das colunas individuais ou usar a caixa de dilogo Sugerir Tipos de Coluna para mapear automaticamente as colunas de dados extrados para os tipos de dados Integration Services. Voc deve criar um novo gerenciador de conexes de Arquivos Simples para cada formato de arquivo com os quais voc trabalha. Como este tutorial extrai dados de vrios arquivos simples que apresentam exatamente o mesmo formato de dados, ser preciso adicionar e configurar apenas um gerenciador de conexes de Arquivos Simples para seu pacote. Neste tutorial, sero configuradas as seguintes propriedades em seu gerenciador de conexes de Arquivos Simples: Nomes de coluna Como o arquivo simples no tem nomes de colunas, o gerenciador de conexes de Arquivos Simples cria nomes de colunas padro. Estes nomes padres no so teis para identificar o que cada coluna representa. Para tornar esses nomes mais teis, altere os nomes padro para nomes que correspondam tabela de fatos qual os dados do arquivo simples sero carregados. Mapeamentos de dados Os mapeamentos de tipo de dados que forem especificados no gerenciador de conexes de Arquivos Simples sero usados por todos os componentes de origem de dados de arquivos simples que fazem referncia ao gerenciador de conexes. Os tipos de dados podem ser mapeados manualmente usando o gerenciador de conexes de Arquivos Simples ou a caixa de dilogoSugerir Tipos de Coluna. Neste tutorial, sero exibidos os mapeamentos sugeridos na caixa de dilogo Sugerir Tipos de Coluna; em seguida, faa manualmente os mapeamentos necessrios na caixa de dilogo Editor do Gerenciador de Conexes de Arquivos Simples.

O gerenciador de conexes de Arquivos Simples fornece informaes de localidade sobre o arquivo de dados. Se o seu computador no estiver configurado para usar a opo regional Ingls (Estados Unidos), ser preciso definir propriedades adicionais na caixa de dilogo Editor do Gerenciador de Conexes de Arquivos Simples. Para adicionar um gerenciador de conexes de Arquivo Simples

1. Clique com o boto direito do mouse na rea Gerenciadores de Conexes e clique em Nova Conexo de Arquivos Simples. 2. Na caixa de dilogo Editor do Gerenciador de Conexes de Arquivos Simples, em Nome do gerenciador de conexes, digite Dados da Fonte de Arquivos Simples de Exemplo. 3. Clique em Procurar. 4. Na caixa de dilogo Abrir, localize a pasta de dados de exemplo e abra o arquivo SampleCurrencyData.txt. Definir propriedades com distino de localidade

1. Na caixa de dilogo Editor do Gerenciador de Conexes de Arquivos Simples, clique em Geral.

2. Defina a Localidade como o ingls (Estados Unidos) e a Pgina de cdigos como 1252. Renomear colunas no gerenciador de conexes de Arquivos Simples

1. Na caixa de dilogo Editor do Gerenciador de Conexes de Arquivos Simples, clique em Avanado. 2. No painel de propriedade, faa as seguintes alteraes: o Altere a propriedade de nome da Coluna 0 para AverageRate. o Altere a propriedade de nome da Coluna 1 para CurrencyID. o Altere a propriedade de nome da Coluna 2 para CurrencyDate. o Altere a propriedade de nome da Coluna 3 para EndOfDayRate. Observao: Por padro, as quatro colunas so definidas inicialmente como um tipo de dados de cadeia de caracteres [DT_STR] com uma OutputColumnWidth de 50. Remapear tipos de dados de coluna

1. Na caixa de dilogo Editor do Gerenciador de Conexes de Arquivos Simples, clique em Sugerir Tipos. Integration Services sugere automaticamente os tipos de dados mais apropriados com base nas primeiras 100 linhas de dados. Tambm possvel alterar essas opes de sugesto para mostrar mais ou menos dados, para especificar o tipo de dados padro para dados inteiro ou booleano, ou para adicionar espaos como preenchimento das colunas de cadeia de caracteres. Por enquanto, no faa as alteraes nas opes na caixa de dilogo Sugerir Tipos de Coluna e clique em OK para que Integration Services sugira os tipos de dados para as colunas. Esse procedimento retornar o painel Avanado da caixa de dilogo Editor do Gerenciador de Conexes de Arquivos Simples, onde possvel exibir os tipos de dados de coluna sugeridos por Integration Services. (Se voc clicar em Cancelar, nenhuma sugesto ser indicada para os metadados da coluna e o tipo de dados da cadeia de caracteres padro (DT_STR) ser usado.) Neste tutorial, Integration Services sugere os tipos de dados mostrados na segunda coluna da tabela a seguir referentes aos dados do arquivo SampleCurrencyData.txt. Entretanto, os tipos de dados que forem necessrios para as colunas no destino, que sero definidos em uma tarefa futura, sero mostrados na ltima coluna da tabela a seguir. Coluna de Arquivos Tipo Sugerido Simples AverageRate CurrencyID CurrencyDate EndOfDayRate Valores [DT_R4] Coluna de Destino Tipo Destino de

Flutuantes FactCurrencyRate.AverageRate

Valores Flutuantes

Cadeia de Caracteres DimCurrency.CurrencyAlternateKey nchar(3) [DT_STR] Data [DT_DATE] Valores [DT_R4] DimTime.FullDateAlternateKey datetime Valores Flutuantes Flutuantes FactCurrencyRate.EndOfDayRate

Os tipos de dados sugeridos para as colunas CurrencyID e CurrencyDate no so compatveis com os tipos de dados dos campos na tabela de destino. Como o tipo de dados deDimCurrency.CurrencyAlternateKey nchar (3), CurrencyID deve ser alterado de cadeia de caracteres [DT_STR] para a cadeia de caracteres [DT_WSTR]. Alm disso, o campo DimTime.FullDateAlternateKey definido como um tipo de dados DateTime; portanto, CurrencyDate deve ser alterado da data [DT_Date] para o carimbo de data e hora da base de dados [DT_DBTIMESTAMP]. 2. No painel de propriedade, altere o tipo de dados de coluna CurrencyID de cadeia de caracteres [DT_STR] para cadeia de caracteres de Unicode [DT_WSTR]. 3. No painel de propriedade, altere o tipo de dados de coluna CurrencyDate da data [DT_DATE] para o carimbo de data e hora da base de dados [DT_DBTIMESTAMP]. 4. Clique em OK.

Tarefa 3: Adicionando e configurando um gerenciador de conexes OLE DB

Depois de ter adicionado um gerenciador de conexes de arquivo simples para conectar-se origem de dados, a prxima tarefa adicionar um gerenciador de conexes OLE DB para conectar-se ao destino. Um gerenciador de conexes OLE DB permite que um pacote extraia dados de qualquer origem de dados compatvel com OLE DB ou carregue dados ali. Usando o gerenciador de conexes OLE DB, voc pode especificar o servidor, o mtodo de autenticao e o banco de dados padro para a conexo. Nesta lio, voc criar um gerenciador de conexes OLE DB que usa a Autenticao do Windows para conectar-se instncia local do AdventureWorksDB. O gerenciador de conexes OLE DB que voc criar tambm ser referenciado por outros componentes que voc criar posteriormente neste tutorial, como, por exemplo, a transformao Pesquisa e o destino OLE DB. Para adicionar e configurar um gerenciador de conexes OLE DB

1. Com o boto direito do mouse, clique em qualquer lugar na rea Gerenciadores de Conexes e em Nova Conexo OLE DB. 2. Na caixa de dilogo Configurar Gerenciador de Conexes OLE DB, clique em Novo. 3. Para Nome do servidor, digite localhost. Quando voc especifica localhost como o nome do servidor, o gerenciador de conexes se conecta instncia padro do SQL Server no computador local. Para usar uma instncia remota do SQL Server, substitua localhost pelo nome do servidor ao qual voc deseja se conectar. 4. No grupo Fazer logon no servidor, verifique se a opo Usar Autenticao do Windows est selecionada. 5. No grupo Conectar a um banco de dados, na caixa Selecionar um digitar um nome de banco de dados, digite ou selecione AdventureWorksDW. 6. Clique em Testar Conexo para verificar se as configuraes de conexo que voc especificou so vlidas. 7. Clique em OK. 8. Clique em OK. 9. No painel Conexes de Dados da caixa de dilogo Configurar Gerenciador de Conexes OLE DB, verifique se a opo localhost.AdventureWorksDW est selecionada. 10. Clique em OK.

Tarefa 4: Adicionando uma tarefa de fluxo de dados ao pacote

Depois de criar os gerenciadores de conexes para os dados de origem e destino, a prxima tarefa adicionar a tarefa Fluxo de Dados ao seu pacote. Essa tarefa encapsula o mecanismo de fluxo de dados que move dados entre as origens e os destinos, alm de fornecer funcionalidade para transformar, limpar e modificar os dados medida que so movidos. A tarefa Fluxo de Dados onde a maioria do trabalho de um processo de extrao, transformao e carregamento (ETL) acontece.
Observao: SQL Server Integration Services separa o fluxo de dados de fluxo de controle. Essa separao de fluxos uma das diferenas significativas entre Integration Services e os Servios de Transformao de Dados de Microsoft SQL Server 2000.

Adicionar uma tarefa Fluxo de Dados

1. Clique na guia Fluxo de Controle. 2. Na Caixa de Ferramentas, expanda Itens de Fluxo de Controle e arraste uma Tarefa de Fluxo de Dados para a superfcie de design da guia Fluxo de Controle. 3. Na superfcie de design Fluxo de Controle, clique com o boto direito do mouse na Tarefa de Fluxo de Dados, clique em Renomear e altere o nome para Extrair Dados de Moeda de Exemplo. uma boa idia fornecer nomes exclusivos a todos os componentes que voc adiciona a uma superfcie de design. Para facilitar o uso e a sustentabilidade, os nomes devem descrever a funo que cada componente executa. Seguir estas diretrizes de nomeao permite que seus pacotes Integration Services sejam documentados automaticamente. Outra forma para documentar seus pacotes usar anotaes. 4. Clique com o boto direito do mouse na tarefa Fluxo de Dados, clique em Propriedades e, na janela Propriedades, verifique se a propriedade LocaleID est definida como Ingls (Estados Unidos).

Tarefa 5: Adicionando e configurando a fonte de arquivo simples

Nesta tarefa, voc ir adicionar e configurar uma fonte de arquivo simples ao seu pacote. Uma fonte de arquivo simples um componente de fluxo de dados que usa metadados definidos por um gerenciador de conexes de arquivo simples para especificar o formato e a estrutura dos dados que sero extrados do arquivo simples por um processo de transformao. Uma fonte de arquivo simples pode ser configurada para extrair dados de uma nica fonte de arquivo simples usando a definio de formato de arquivo fornecida pelo gerenciador de conexes do arquivo simples. Para este tutorial, voc ir configurar a fonte de arquivo simples para usar o gerenciador de conexes Dados da Fonte de Arquivo Simples de Exemplo criada anteriormente. Para adicionar um componente Fonte de Arquivo Simples

1. Abra o designer Fluxo de Dados, clicando duas vezes na tarefa de fluxo de dados Extrair Dados de Moeda de Exemplo ou clicando na guia Fluxo de Dados. 2. Na Caixa de Ferramentas, expanda Origens do Fluxo de Dados e arraste uma Fonte de Arquivo Simples para a superfcie de design da guia Fluxo de Dados. 3. Na superfcie de design Fluxo de Dados, clique com o boto direito do mouse na Fonte de Arquivo Simples recm-adicionada, clique em Renomear e altere o nome para Extrair Dados de Moeda de Exemplo. 4. Clique duas vezes na Fonte de Arquivo Simples para abrir a caixa de dilogo Editor da Fonte de Arquivo Simples. 5. Na caixa Gerenciador de conexes de arquivo simples, digite ou selecione Dados de Exemplo da Fonte de Arquivo Simples. 6. Clique em Colunas e verifique se os nomes das colunas esto corretos. 7. Clique em OK. 8. Clique com o boto direito do mouse na fonte de arquivo simples e clique em Propriedades. 9. Na janela Propriedades, verifique se a propriedade LocaleID est definida como Ingls (Estados Unidos).

Tarefa 6: Adicionando e configurando a transformao Pesquisa

Depois de configurar a fonte de Arquivo Simples para extrair dados do arquivo de origem, a prxima tarefa definir as transformaes Pesquisa necessrias para obter os valores para CurrencyKey e TimeKey. Uma transformao Pesquisa executa uma pesquisa ao unir dados na entrada coluna para uma coluna especificada em um conjunto de dados referenciado. O conjunto de dados de referncia pode ser uma tabela existente ou visualizao, uma nova tabela ou o resultado de uma instruo SQL. Neste tutorial, a transformao Pesquisa usa um gerenciador de conexes OLE DB para conectar-se ao banco de dados que contm os dados que a fonte do conjunto de dados de referncia. Para este tutorial, voc ir adicionar e configurar os dois componentes de transformaes Pesquisa a seguir para o pacote: Uma transformao para executar uma pesquisa de valores na coluna CurrencyKey da tabela de dimenses DimCurrency baseada nos valores da coluna CurrencyID correspondentes do arquivo simples. Uma transformao para executar uma pesquisa de valores na coluna TimeKey da tabela de dimenses DimTime baseada nos valores da coluna CurrencyDate correspondentes do arquivo simples.

Em ambos os casos, as transformaes Pesquisa utilizaro o gerenciador de conexes OLE DB que voc criou anteriormente. Para adicionar e configurar a transformao Cdigo de Moeda da Pesquisa

1. Na Caixa de Ferramentas, expanda as Transformaes Fluxo de Dados e, ento, arraste Pesquisa para a superfcie de design da guia Fluxo de Dados. Coloque Pesquisa diretamente abaixo da fonte Extrair Dados de Exemplo de Moeda . 2. Clique na fonte de arquivo simples Extrair Dados de Exemplo de Moeda e arraste a seta verde para a recm-adicionada transformao Pesquisa para poder conectar os dois componentes. 3. Na superfcie de design de Fluxo de Dados, clique em Pesquisa na transformao Pesquisa e altere o nome para Pesquisa de Cdigo de Moeda . 4. Clique duas vezes na transformao Pesquisa de Cdigo de Moeda . 5. Na pgina Geral, faa as seguintes selees: 1. Selecione Cache cheio. 2. Na rea Tipo de conexo, selecione Gerenciador de conexes OLE DB. 6. Na pgina Conexo, faa as seguintes selees: 1. Na caixa Gerenciador de conexes OLE DB, verifique se localhost.AdventureWorksDW est exibido. 2. Selecione Usar os resultados de uma consulta SQL e digite ou copie a seguinte instruo SQL: select * from (select * from [dbo].[DimCurrency]) as refTable where [refTable].[CurrencyAlternateKey] = 'ARS' OR [refTable].[CurrencyAlternateKey] = 'AUD' OR [refTable].[CurrencyAlternateKey] = 'BRL' OR [refTable].[CurrencyAlternateKey] = 'CAD' OR [refTable].[CurrencyAlternateKey] = 'CNY' OR [refTable].[CurrencyAlternateKey] = 'DEM'

OR [refTable].[CurrencyAlternateKey] = 'EUR' OR [refTable].[CurrencyAlternateKey] = 'FRF' OR [refTable].[CurrencyAlternateKey] = 'GBP' OR [refTable].[CurrencyAlternateKey] = 'JPY' OR [refTable].[CurrencyAlternateKey] = 'MXN' OR [refTable].[CurrencyAlternateKey] = 'SAR' OR [refTable].[CurrencyAlternateKey] = 'USD' OR [refTable].[CurrencyAlternateKey] = 'VEB' 7. Na pgina Colunas, faa as seguintes selees: 1. No painel Colunas de Entrada Disponveis, arraste CurrencyID para o painel Colunas de Pesquisa Disponveis e solte em CurrencyAlternateKey. 2. Na lista Colunas de Pesquisa Disponveis, marque a caixa de seleo direita de CurrencyKey. 8. Clique em OK para retornar superfcie de design Fluxo de Dados. 9. Clique com o boto direito do mouse na transformao Pesquisa de Cdigos de Moeda, clique em Propriedades. 10. Na janela Propriedades, verifique se a propriedade LocaleID est definida para Ingls (Estados Unidos) e se propriedade DefaultCodePage est definida para 1252. Para adicionar e configurar a transformao Pesquisa de Chave de Data

1. Na Caixa de Ferramentas, arraste Pesquisa at a superfcie de design de Fluxo de Dados . Coloque Pesquisa diretamente abaixo da transformao Lookup CurrencyKey . 2. Clique na transformao Pesquisa de Cdigo de Moeda e depois arraste a seta verde para a transformao recentemente adicionada Pesquisa para conectar os dois componentes. 3. Na caixa de dilogo Seleo de Sada e Entrada, clique em Sada de Correspondncia de Pesquisa na caixa de listagem Sada e clique em OK. 4. Na superfcie de design Fluxo de Dados, clique em Pesquisa na recm-adicionada transformao Pesquisa e altere o nome para Pesquisa de Cdigo de Data . 5. Clique duas vezes na transformao Pesquisa de Cdigo de Data . 6. Na pgina Geral, selecione Cache parcial. 7. Na pgina Conexo, faa as seguintes selees: 1. Na caixa Gerenciador de conexes OLE DB, verifique se localhost.AdventureWorksDW est exibido. 2. Na caixa Usar uma tabela ou visualizao, digite ou selecione [dbo]. [DimTime]. 8. Na pgina Colunas, faa as seguintes selees: 1. No painel Colunas de Entrada Disponveis, arraste CurrencyDate para o painel Colunas de Pesquisa Disponveis e solte em FullDateAlternateKey. 2. Na lista Colunas de Pesquisa Disponveis, marque a caixa de seleo direita de TimeKey. 9. Na pgina Avanado, examine as opes de cache. 10. Clique em OK para retornar superfcie de design Fluxo de Dados. 11. Clique com o boto direito na transformao Pesquisa de Cdigo de Data, e clique em Propriedades. 12. Na janela Propriedades, verifique se a propriedade LocaleID est definida para Ingls (Estados Unidos) e se propriedade DefaultCodePage est definida para 1252.

Tarefa 7: Adicionando e configurando o destino OLE DB

Seu pacote agora extrai dados de uma fonte de arquivo simples e transforma esses dados em um formato compatvel com o destino. A prxima tarefa carregar os dados transformados no destino. Para carregar os dados, voc deve adicionar um destino OLE DB ao fluxo de dados. O destino do OLE DB pode usar uma tabela, exibio de banco de dados ou um comando SQL para carregar os dados em uma diversidade de bancos de dados compatveis com o OLE DB. Neste procedimento, voc adiciona e configura um destino OLE DB para usar o gerenciador de conexes OLE DB criado anteriormente. Para adicionar e configurar a amostra de destino do OLE DB

1. Na Caixa de Ferramentas, expanda Destinos de Fluxo de Dados e arraste OLE DB para a superfcie de design da guia Fluxo de Dados. Coloque o destino de OLE DB diretamente abaixo da transformaoChave de Data de Pesquisa. 2. Clique na transformao Chave de Data de Pesquisa e arraste a seta verde sobre o recm-adicionado Destino OLE DB para conectar os dois componentes. 3. Na caixa de dilogo Seleo de Sada e Entrada, na caixa de listagem Sada, clique em Sada de Correspondncia de Pesquisa e clique em OK. 4. Na superfcie de design de Fluxo de Dados, clique em Destino OLE DB, no componente recm-adicionado Destino de OLE DB, e altere o nome para Exemplo de Destino de OLE DB. 5. Clique duas vezes em Exemplo de Destino de OLE DB. 6. Na caixa de dilogo Editor de Destino do OLE DB , certifique-se de que localhost.AdventureWorksDW est selecionado na caixa Gerente de Conexes de OLE DB. 7. Na caixa Nome da tabela ou da exibio, digite ou selecione [dbo]. [FactCurrencyRate]. 8. Clique em Mapeamentos. 9. Verifique se as colunas de entrada AverageRate, CurrencyKey, EndOfDayRatee TimeKey esto mapeadas corretamente para as colunas de destino. Se forem mapeadas colunas com o mesmo nome, o mapeamento estar correto. 10. Clique em OK. 11. Clique com o boto direito do mouse no destino Exemplo de Destino OLE DB e clique em Propriedades. 12. Na janela Propriedades, verifique se a propriedade LocaleID est definida como Ingls (Estados Unidos) e se a propriedade DefaultCodePage est definida como 1252.

Tarefa 8: Tornando o pacote da Lio 1 mais fcil de compreender

Agora que voc concluiu a configurao do pacote da Lio 1, uma boa idia verificar o layout do pacote. Se as formas dos layouts de controle e dos fluxos de dados so de tamanhos aleatrias ou se as formas no esto alinhadas ou agrupadas, a funcionalidade de pacote pode ser mais difcil de ser entendida. O Business Intelligence Development Studio fornece ferramentas que tornam mais fcil e rpida a formatao do layout do pacote. Os recursos de formatao incluem a capacidade de criar formas do mesmo tamanho, alinhar formas e manipular o espaamento horizontal e vertical entre os espaamentos. Outro modo para melhorar a compreenso de funcionalidade de pacote adicionar anotaes que descrevem a funcionalidade do pacote. Nesta tarefa, voc utilizar os recursos de formatao no Business Intelligence Development Studio para melhorar o layout do fluxo de dados e tambm adicionar uma anotao ao fluxo de dados. Para formatar o layout do fluxo de dados

1. Se o pacote da Lio 1 ainda no estiver aberto, no Gerenciador de Solues, clique duas vezes em Lio 1.dtsx. 2. Clique na guia Fluxo de Dados. 3. Posicione o cursor na parte superior e direita da transformao Extrair Moeda de Exemplo e clique e arraste o cursor por todos os componentes do fluxo de dados. Todos os componentes de fluxo de dados sero selecionados. A primeira forma selecionada a forma cujos indicadores selecionados de cor branca indica o tamanho e o local usados na formatao do layout. 4. No menu Formatar, aponte para Igualar Tamanho e clique em Ambos. 5. Com os objetos de fluxo de dados selecionados, no menu Formatar, aponte para Alinhar e clique em esquerda. Para adicionar uma anotao ao fluxo de dados

1. Clique com o boto direito do mouse no plano de fundo da superfcie de design de fluxo de dados e clique em Adicionar Anotao. 2. Digite ou cole o texto a seguir na caixa de anotao. O fluxo de dados extrai os dados a partir de um arquivo, pesquisa valores na coluna CurrencyKey da tabela DimCurrency e na coluna TimeKey na tabela DimTime, alm de gravar os dados na tabela FactCurrencyRate. Para usar a quebra de linhas no texto da caixa de anotao, posicione o cursor no local que deseja comear uma nova linha e pressione as teclas Ctrl e Enter. Se voc no inserir um texto na caixa de anotao, essa caixa desaparecer ao clicar fora dela.

Tarefa 9: Testando o pacote de tutorial da Lio 1

Nesta lio, voc executou as seguintes tarefas: Criou um novo projeto do SSIS. Configurou os gerenciadores de conexes que o pacote precisa para estabelecer conexo com os dados de origem e de destino. Adicionou um fluxo de dados que usa os dados de uma origem de arquivo simples, desenvolve as transformaes Pesquisa necessrias sobre os dados e configura os dados para o destino.

Seu pacote est completo agora! Est na hora de testar seu pacote. Verificando o layout do pacote

Antes de testar o pacote, recomendvel verificar se os fluxos de controle e de dados do pacote da Lio 1 contm os objetos mostrados nos diagramas a seguir. Fluxo de Controle

Fluxo de Dados

Para executar o pacote de tutorial da Lio 1

1. No menu Depurar, clique em Iniciar Depurao. O pacote ser executado, resultando na adio bem-sucedida de 1097 linhas tabela de fatos FactCurrencyRate em AdventureWorksDW. 2. Terminada a execuo do pacote, no menu Depurar, clique em Parar Depurao.

Lio 2: Adicionando loop

Na Lio 1: Criando o projeto e pacote bsico, voc criou um pacote que extraiu dados de uma nica fonte de arquivo simples, transformou os dados usando transformaes Pesquisa e, finalmente, carregou os dados na tabela de fatos FactCurrencyRate do banco de dados de exemplo AdventureWorksDW. Porm, raro para um processo de extrao, transformao e carregamento (ETL) usar um nico arquivo simples. Um tpico processo ETL extrairia dados de vrias fontes de arquivo simples. Extrair dados de vrias fontes requer um fluxo de controle iterativo. Um dos recursos mais antecipados do Microsoft Integration Services a habilidade de adicionar iteraes ou loops aos pacotes de forma fcil. O Integration Services fornece dois tipos de contineres para efetuar loop atravs de pacotes: o Loop Foreach e o Loop For. O continer Loop Foreach usa um enumerador para executar o loop, enquanto que o Loop For geralmente usa uma expresso de varivel. Esta lio usa o continer Loop Foreach. O continer Loop Foreach habilita um pacote a repetir o fluxo de controle para cada membro de um enumerador especificado. Com o continer Loop Foreach, voc pode enumerar: Conjuntos de registros ADO e informaes de esquema Estruturas de arquivo e diretrio Variveis de sistema, pacote e usurio SQL Server Management Objects (SMO)

Nesta lio, voc modificar o pacote ETL simples criado na lio 1 para aproveitar o continer Loop Foreach. Voc tambm ajustar as variveis do pacote definidas pelo usurio para habilitar o pacote do tutorial a ser iterado por todos os arquivos simples na pasta. Se voc no tiver completado a lio anterior, tambm poder copiar o pacote da Lio 1 terminada, que est includo no tutorial. Nesta lio, voc no modificar o fluxo de dados, apenas o fluxo de controle.

Tarefa 1: Copiando o pacote da Lio 1

Nesta tarefa, voc criar uma cpia do pacote Lesson 1.dtsx que voc criou na lio 1. Se voc no completou a lio 1, poder adicionar o pacote completo da lio 1 includo com o tutorial do projeto e, ento, copiar esse pacote. Voc usar esta cpia nova ao longo de toda a lio 2. Para criar o pacote da lio 2

1. Se o Business Intelligence Development Studio ainda no estiver aberto, clique em Iniciar, aponte para Todos os Programas, aponte para Microsoft SQL Server e clique em Business Intelligence Development Studio. 2. No menu Arquivo, clique em Abrir, clique em Projeto/Soluo, clique na pasta Tutorial do SSIS, clique em Abrir e clique duas vezes em SSIS Tutorial.sln. 3. No Solution Explorer, clique com o boto direito em Lesson 1.dtsx e, em seguida, clique em Copiar. 4. No Gerenciador de Solues, clique com o boto direito do mouse em Pacotes SSIS e clique em Colar. Por padro, o pacote copiado receber o nome de Lesson 2.dtsx. 5. No Solution Explorer, clique duas vezes em Lesson 2.dtsx para abrir o pacote. 6. Clique com o boto direito do mouse no plano de fundo da superfcie de design Fluxo de Controle e clique em Propriedades. 7. Na janela Propriedades, atualize a propriedade Name para Lio 2. 8. Clique na caixa da propriedade ID e clique em <Gerar Nova ID>. Para adicionar o pacote concludo da lio 1

1. Abra o Business Intelligence Development Studio e abra o projeto do Tutorial do SSIS. 2. No Gerenciador de Solues, clique com o boto direito do mouse em Pacotes SSIS e clique em Adicionar Pacote Existente. 3. Na caixa de dilogo Adicionar Cpia do Pacote Existente, em Local do Pacote, selecione Sistema de Arquivos. 4. Clique no boto de navegao (...), navegue at C:\Arquivos de Programas\Microsoft SQL Server\100\Exemplos\Integration Services\Tutorial\Criando um tutorial de pacote ETL simples\Pacotes Concludos, selecione Lesson 1.dtsx e, em seguida, clique em Abrir. 5. Copie e cole o pacote da Lio 1 conforme descrito nas etapas de 3 a 8 do procedimento anterior.

Tarefa 2: Adicionando e configurando o continer Loop Foreach

Nessa tarefa, voc adicionar a capacidade de executar loop atravs de uma pasta de arquivos simples e aplicar a mesma transformao Fluxo de Dados usada na Lio 1 para cada um desses arquivos simples. Voc faz isto adicionando e configurando um continer Loop Foreach ao fluxo de controle. O continer Loop Foreach que voc adicionar deve ser capaz de se conectar a cada arquivo simples na pasta. Como todos os arquivos da pasta tm o mesmo formato, o continer Loop Foreach pode usar o mesmo gerenciador de conexes de Arquivo Simples para conectar-se a cada um desses arquivos. O gerenciador de conexes de Arquivo Simples que o continer usar o mesmo gerenciador de conexes de Arquivo Simples que voc criou na Lio 1. Atualmente, o gerenciador de conexes de Arquivo Simples da Lio 1 se conecta a um nico arquivo simples especfico. Para conectar-se iterativamente a cada arquivo simples da pasta, voc ter que configurar o continer Loop Foreach e o gerenciador de conexes de Arquivo Simples da seguinte maneira: Continer Loop Foreach Voc mapear o valor enumerado do continer para uma varivel de pacote definida pelo usurio. O continer usar a varivel definida pelo usurio para modificar dinamicamente a propriedade ConnectionString do gerenciador de conexes de Arquivo Simples, e conectar-se iterativamente a cada um dos arquivos simples da pasta. Gerenciador de conexes de Arquivo Simples Voc modificar o gerenciador de conexes que criou na Lio 1 usando uma varivel definida pelo usurio para popular a propriedade ConnectionString do gerenciador de conexes.

Os procedimentos nessa tarefa mostram como voc pode criar e modificar o continer Loop Foreach para usar uma varivel definida pelo usurio e adicionar a tarefa de fluxo de dados ao loop. Voc aprender como modificar o gerenciador de conexes de Arquivo Simples para usar uma varivel definida pelo usurio na prxima tarefa. Aps essas modificaes no pacote, quando ele for executado, o continer Loop Foreach iterar atravs dessa coleo de arquivos na pasta Dados de Exemplo. Toda vez que um arquivo encontrado e corresponde ao critrio, o continer Loop Foreach ir popular a varivel definida pelo usurio com o nome do arquivo, mapear a varivel definida pelo usurio para a propriedade ConnectionString do gerenciador de conexes do Arquivo Simples de Dados Moeda de exemplo e, ento, executar o fluxo de dados naquele arquivo. Portanto, em cada iterao do Loop Foreach a tarefa de Fluxo de Dados consumir um arquivo simples diferente.
Observao: Como o Microsoft Integration Services separa o fluxo de controle do fluxo de dados, qualquer loop que voc adicionar ao fluxo de controle no exigir modificaes no fluxo de dados. Portanto, o fluxo de dados que voc criou na Lio 1 no tem que ser alterado.

Para adicionar um continer Loop Foreach

1. Em Business Intelligence Development Studio, clique na guia Fluxo de Controle. 2. Na Caixa de Ferramentas, expanda Itens de Fluxo de Controle e, ento, arraste um Continer Loop Foreach at a superfcie de design na guia Fluxo de Controle. 3. Clique com o boto direito do mouse no recm-adicionado Continer Loop Foreach e selecione Editar. 4. Na caixa de dilogo Editor de Loop Foreach, na pgina Geral, como Nome, digite Arquivo Foreach na Pasta. Clique em OK. 5. Clique com o boto direito do mouse no continer Loop Foreach, clique em Propriedades e na janela Propriedades, verifique se a propriedade LocaleID est definida como Ingls (Estados Unidos).

Para configurar o enumerador para o continer Loop Foreach

1. Clique duas vezes no Arquivo Foreach para abrir novamente o Editor de Loop Foreach. 2. Clique em Coleo. 3. Na pgina Coleo, selecione Enumerador de Arquivo Foreach. 4. No grupo Configurao do Enumerador, clique em Procurar. 5. Na caixa de dilogo Procurar pasta, localize a pasta de dados de exemplo que contm os dados de exemplo do tutorial. Por padro, a pasta de exemplos do tutorial est instalada na pasta C:\Arquivos de Programas\Microsoft SQL Server\100\Samples\Integration Services\Tutorial\Creating a Simple ETL Package\Sample Data. 6. Na caixa Arquivos, digite Currency_*.txt. Para mapear o enumerador para uma varivel definida pelo usurio

1. Clique em Mapeamentos de Variveis. 2. Na pgina Mapeamentos de Variveis, na coluna Varivel, clique na clula vazia e selecione <Nova varivel>. 3. Na caixa de dilogo Adicionar Varivel, para Nome, digite varFileName.
Importante: Nomes de variveis fazem diferenciao de maisculas e minsculas.

4. Clique em OK. 5. Clique em OK novamente para fechar a caixa de dilogo Editor de Loop Foreach. Para adicionar a tarefa de fluxo de dados ao loop

Arraste a tarefa de fluxo de dados Extrair Dados de Moeda de Exemplo para o continer Loop Foreach agora renomeado Arquivo Foreach na Pasta.

Tarefa 3: Modificando o Gerenciador de Conexes de Arquivo Simples

Nesta tarefa, voc modificar o gerenciador de conexes de arquivo simples que voc criou e configurou na Lio 1. Quando foi criado originalmente, o gerenciador de conexes de arquivo simples foi configurado para carregar estatisticamente um nico arquivo. Para habilitar o gerenciador de conexes de arquivo simples para carregar arquivos iterativamente, voc deve modificar a propriedade ConnectionString do gerenciador de conexes para aceitar a varivel definida pelo usurio User:varFileName, que contm o caminho do arquivo a ser carregado no tempo de execuo. Modificando o gerenciador de conexes para usar o valor da varivel definida pelo usurio, User::varFileName, para popular a propriedade ConnectionString do gerenciador de conexes, o gerenciador de conexes poder conectar-se a diferentes arquivos simples. No tempo de execuo, cada iterao do continer Loop Foreach atualizar dinamicamente a varivel User::varFileName. Atualizar a varivel, por sua vez, faz com que o gerenciador de conexes se conecte a um arquivo simples diferente e a tarefa de fluxo de dados processe um conjunto diferente de dados. Para configurar o gerenciador de conexes de arquivo simples para usar uma varivel para a cadeia de conexo

1. No painel Gerenciadores de Conexes, clique com o boto direito do mouse em Dados de Fonte de Arquivo Simples de Exemplo e selecione Propriedades. 2. Na janela Propriedades, para Expresses, clique na clula vazia e ento clique no boto de reticncias (...). 3. Na caixa de dilogo Editor de Expresses de Propriedades, na coluna Propriedade, digite ou selecione ConnectionString. 4. Na coluna Expresso, clique no boto de reticncias (...) para abrir a caixa de dilogo Construtor de Expresses. 5. Na caixa de dilogo Construtor de Expresso, expanda o n Variveis. 6. Arraste a varivel, User::varFileName, para a caixa Expresso. 7. Clique em OK para fechar a caixa de dilogo Construtor de Expresso. 8. Clique em OK novamente para fechar a caixa de dilogo Editor de Expresses de Propriedades.

Tarefa 4: Testando o pacote de tutorial da Lio 2

Com o continer Loop Foreach e o gerenciador de conexes de Arquivo Simples agora configurado, o pacote da Lio 2 pode iterar atravs da coleo de 14 arquivos simples na pasta Dados de Exemplo. Cada vez que um nome de arquivo encontrado e corresponde aos critrios de nome de arquivo especificado, o continer Loop Foreach popula a varivel definida pelo usurio com o nome do arquivo. Essa varivel, por sua vez, atualiza a propriedade ConnectionString do gerenciador de conexes de Arquivo Simples e uma conexo criada para o novo arquivo simples. O continer Loop Foreach, ento, executa a tarefa de fluxo de dados no modificados em relao aos dados no novo arquivo simples, antes de se conectar ao prximo arquivo na pasta. Use o procedimento a seguir para testar a nova funcionalidade de loop que voc adicionou ao seu pacote. Verificando o layout do pacote

Antes de testar o pacote voc deve verificar se os fluxos de controle e de dados do pacote da lio 2 contm os objetos mostrados nos diagramas a seguir. O fluxo de dados deve ser idntico ao fluxo de dados na lio 1. Fluxo de controle

Fluxo de dados

Para testar o pacote de tutorial da lio 2

1. No menu Depurar, clique em Iniciar Depurao. O pacote ser executado. Voc pode verificar o status de cada loop na janela Sada ou clicando na guia Progresso. Por exemplo, voc pode ver que foram adicionadas 1097 linhas tabela de destino do arquivo Currency_VEB.txt. 2. Terminada a execuo do pacote, no menu Depurar, clique em Parar Depurao.

Lio 3: Adicionando configuraes de pacote

As configuraes de pacote deixam voc definir propriedades de tempo de execuo e variveis de fora do ambiente de desenvolvimento. As configuraes permitem que voc desenvolva pacotes que so flexveis e fceis de implementar e distribuir. O Microsoft Integration Services oferece os seguintes tipos de configurao: Arquivo de configurao XML Varivel de ambiente Entrada de registro Varivel de pacote pai Tabela SQL Server

Nesta lio, voc ir modificar o pacote simples Integration Services criados no Lio 2: Adicionando loop para aproveitar as configuraes de pacote. Voc tambm pode copiar o pacote concludo da Lio 2 que est incluso no tutorial. Usando o Assistente de Configurao de Pacote, voc ir criar uma configurao XML que atualiza a propriedade Directory do continer Loop Foreach utilizando uma varivel de nvel de pacote mapeada para a propriedade do Diretrio. Depois de criar um arquivo de configurao, voc modificar o valor da varivel de fora do ambiente de desenvolvimento e apontar a propriedade modificada para uma nova pasta de dados de exemplo. Quando voc executa o pacote novamente, o arquivo de configurao popula o valor da varivel e a varivel por sua vez atualiza a propriedade Directory . Como resultado, o pacote itera atravs dos arquivos na nova pasta de Tarefas da lio

Esta lio contm as seguintes tarefas: Tarefa 1: Copiando o pacote da Lio 2 Tarefa 2: Configurando e habilitando configuraes de pacote Tarefa 3: Modificando o valor de configurao da propriedade de diretrio Tarefa 4: Testando o pacote de tutorial da Lio 3

Tarefa 1: Copiando o pacote da Lio 2

Nesta tarefa, voc criar uma cpia do pacote Lesson 2.dtsx criado na Lio 2. Como alternativa, possvel adicionar o pacote concludo da Lio 2 includo com o tutorial do projeto e copi-lo. Voc usar esta cpia nova ao longo de toda a lio 3. Para criar o pacote da lio 2

1. Se o Business Intelligence Development Studio ainda no estiver aberto, clique em Iniciar, aponte para Todos os Programas, aponte para Microsoft SQL Server e clique em Business Intelligence Development Studio. 2. No menu Arquivo, clique em Abrir, clique em Projeto/Soluo, selecione Tutorial do SSIS, clique em Abrir e clique duas vezes em SSIS Tutorial.sln. 3. No Gerenciador de Solues, clique com o boto direito do mouse em Lesson 2.dtsx e clique em Copiar. 4. No Gerenciador de Solues, clique com o boto direito do mouse em Pacotes SSIS e clique em Colar. Por padro, o pacote copiado recebe o nome de Lesson 3.dtsx. 5. No Gerenciador de Solues, clique duas vezes em Lesson 3.dtsx para abrir o pacote. 6. Clique com o boto direito do mouse em qualquer local do plano de fundo da guia Fluxo de Controle e clique em Propriedades. 7. Na janela Propriedades, atualize a propriedade Name para Lio 3. 8. Clique na caixa da propriedade ID e, na lista, clique em <Gerar Nova ID>. Para adicionar o pacote concludo da lio 2

1. Abra o Business Intelligence Development Studio e abra o projeto do Tutorial do SSIS. 2. No Gerenciador de Solues, clique com o boto direito do mouse em Pacotes SSIS e clique em Adicionar Pacote Existente. 3. Na caixa de dilogo Adicionar Cpia do Pacote Existente, em Local do Pacote, selecione Sistema de Arquivos. 4. Clique no boto de navegao (...), navegue at C:\Arquivos de Programas\Microsoft SQL Server\100\Exemplos\Integration Services\Tutorial\Criando um pacote ETL simples\Pacotes Concludos, selecione Lesson 2.dtsx e clique em Abrir. 5. Copie e cole o pacote da Lio 2 conforme descrito nas etapas de 3 a 8 do procedimento anterior.

Tarefa 2: Configurando e habilitando configuraes de pacote

Nesta tarefa, voc habilitar configuraes de pacote que usam o Assistente de Configurao de Pacote. Voc usar esse assistente para gerar um arquivo de configurao XML que contenha definies de configurao para a propriedade Directory do continer Loop Foreach. O valor da propriedade de diretrio fornecido por uma nova varivel de nvel de pacote que voc pode atualizar no tempo de execuo. Adicionalmente, voc popular uma pasta de dados de exemplo para usar durante o teste. Para criar uma nova varivel de nvel de pacote mapeada para a propriedade de diretrio

1. Clique no plano de fundo da guia Fluxo de Controle no Designer SSIS. Isso define o escopo da varivel que voc criar para o pacote. 2. No menu SSIS, selecione Variveis. 3. Na janela Variveis, clique no cone Adicionar Varivel. 4. Na caixa Nome, digite varFolderName.
Importante: Nomes de variveis fazem diferenciao de maisculas e minsculas.

5. Verifique se a caixa Escopo mostra o nome do pacote, Lio 3. 6. Defina o valor da caixa Tipo de Dados da varivel varFolderName como Cadeia de Caracteres. 7. Retorne guia Fluxo de Controle e clique duas vezes no continer Arquivo Foreach na Pasta. 8. Na pgina Coleo do Editor do Loop Foreach, clique em Expresses e, em seguida, clique no boto de reticncias (...). 9. No Editor de Expresses de Propriedades, clique na lista Propriedade e selecione Diretrio. 10. Na caixa Expresso, clique no boto de reticncias (...). 11. No Construtor de Expresses, expanda a pasta Variveis e arraste a varivel User::varFolderName para a caixa Expresso. 12. Clique em OK para sair do Construtor de Expresses. 13. Clique em OK para sair do Editor de Expresses de Propriedades. Para habilitar configuraes de pacote

1. Clique no plano de fundo da guia Fluxo de Controle no Designer SSIS. 2. No menu SSIS , clique em Configuraes de Pacote. 3. Na caixa de dilogo Organizador de Configuraes do Pacote, selecione Habilitar Configuraes do Pacote e clique em Adicionar. 4. Na pgina inicial do Assistente de Configurao de Pacotes, clique em Avanar. 5. Na pgina Selecionar Tipo de Configurao, verifique se o Tipo de Configurao est definido como Arquivo de Configurao XML. 6. Na pgina Selecionar Tipo de Configurao, clique em Procurar. 7. Por padro, a caixa de dilogo Selecionar Local do Arquivo de Configurao abrir a pasta do projeto. 8. Na caixa de dilogo Selecionar Local do Arquivo de Configurao, em Nome do Arquivo, digite SSISTutorial e clique em Salvar. 9. Na pgina Selecionar Tipo de Configurao, clique em Avanar. 10. Na pgina Selecionar Propriedades para Exportar, no painel Objetos, expanda Variveis, varFolderName, Propriedades e, em seguida, selecione Valor. 11. Na pgina Selecionar Propriedades para Exportar, clique em Avanar. 12. Na pgina Concluindo o Assistente, digite um nome de configurao para a configurao, como Configurao do Diretrio de Tutoriais do SSIS. Esse o nome

de configurao exibido na caixa de dilogo Organizador de Configuraes do Pacote. 13. Clique em Concluir. 14. Clique em Fechar. 15. O assistente cria um arquivo de configurao, chamado SSISTutorial.dtsConfig, que contm as definies de configurao de value da varivel que define a propriedade Directory do enumerador.
Observao: Um arquivo de configurao geralmente contm informaes complexas sobre as propriedades do pacote, mas, para este tutorial, a nica informao deveria ser [User::varFolderName].Properties[Value].

Para criar e popular uma nova pasta de dados de exemplo

1. No Windows Explorer, no nvel da raiz de sua unidade (por exemplo, C:\), crie uma nova pasta chamada Novos Dados de Exemplo. 2. Abra a pasta c:\Arquivos de Programas\Microsoft SQL Server\100\Samples\Integration Services\Tutorial\Creating a Simple ETL Package\Sample Data e copie um dos trs arquivos de exemplo da pasta. 3. Na pasta Novos Dados de Exemplo, cole os arquivos copiados. Tarefa 3: Modificando o valor de configurao da propriedade de diretrio Nesta tarefa, voc modificar a definio de configurao, armazenada no arquivo de configurao SSISTutorial.dts, para a propriedade Value da varivel de nvel de pacoteUser::varFolderName. A varivel atualiza a propriedade Directory do continer Loop Foreach. O valor modificado apontar para a pasta Novos Dados de Exemplo que voc criou na tarefa anterior. Depois de modificar a definio de configurao e executar o pacote, a propriedade Directory ser atualizada pela varivel, usando o valor preenchido pelo arquivo de configurao e no o valor de diretrio originalmente configurado no pacote. Para modificar a definio de configurao da propriedade de diretrio

1. No Bloco de notas ou em qualquer outro editor de texto, localize e abra o arquivo de configurao SSISTutorial.dts criado usando o Assistente para Configurao de Pacote na tarefa anterior. 2. Altere o valor do elemento ConfiguredValue para corresponder ao caminho da pasta Novos Dados de Exemplo criada na tarefa anterior. No coloque o caminho entre aspas. Se a pasta Novos Dados de Exemplo estiver no nvel da raiz de sua unidade (por exemplo, C:\), o XML atualizado dever ser semelhante ao exemplo: <?xml version="1.0"?><DTSConfiguration><DTSConfigurationHeading><DTSConfigurationFil eInfo GeneratedBy="Domain\UserName" GeneratedFromPackageName="Lesson 3" GeneratedFromPackageID="{99396D72-2F8D-4A37-8362-96346AD53334}" GeneratedDate="11/12/2005 12:46:13 PM"/></DTSConfigurationHeading><Configuration ConfiguredType="Property" Path="\Package.Variables[User::varFolderName].Properties[Value]" ValueType="String"><ConfiguredValue>C:\New Sample Data</ConfiguredValue></Configuration></DTSConfiguration> A informaes de ttulo, GeneratedBy, GeneratedFromPackageID e GeneratedDate sero diferentes em seu arquivo. O elemento a ser anotado Configuration. A propriedadeValue da varivel, User::varFolderName, agora contm C:\Novos Dados... 3. Salve a alterao e feche o editor de textos.

Tarefa 3: Modificando o Gerenciador de Conexes de Arquivo Simples

Nesta tarefa, voc modificar o gerenciador de conexes de arquivo simples que voc criou e configurou na Lio 1. Quando foi criado originalmente, o gerenciador de conexes de arquivo simples foi configurado para carregar estatisticamente um nico arquivo. Para habilitar o gerenciador de conexes de arquivo simples para carregar arquivos iterativamente, voc deve modificar a propriedade ConnectionString do gerenciador de conexes para aceitar a varivel definida pelo usurio User:varFileName, que contm o caminho do arquivo a ser carregado no tempo de execuo. Modificando o gerenciador de conexes para usar o valor da varivel definida pelo usurio, User::varFileName, para popular a propriedade ConnectionString do gerenciador de conexes, o gerenciador de conexes poder conectar-se a diferentes arquivos simples. No tempo de execuo, cada iterao do continer Loop Foreach atualizar dinamicamente a varivel User::varFileName. Atualizar a varivel, por sua vez, faz com que o gerenciador de conexes se conecte a um arquivo simples diferente e a tarefa de fluxo de dados processe um conjunto diferente de dados. Para configurar o gerenciador de conexes de arquivo simples para usar uma varivel para a cadeia de conexo

1. No painel Gerenciadores de Conexes, clique com o boto direito do mouse em Dados de Fonte de Arquivo Simples de Exemplo e selecione Propriedades. 2. Na janela Propriedades, para Expresses, clique na clula vazia e ento clique no boto de reticncias (...). 3. Na caixa de dilogo Editor de Expresses de Propriedades, na coluna Propriedade, digite ou selecione ConnectionString. 4. Na coluna Expresso, clique no boto de reticncias (...) para abrir a caixa de dilogo Construtor de Expresses. 5. Na caixa de dilogo Construtor de Expresso, expanda o n Variveis. 6. Arraste a varivel, User::varFileName, para a caixa Expresso. 7. Clique em OK para fechar a caixa de dilogo Construtor de Expresso. 8. Clique em OK novamente para fechar a caixa de dilogo Editor de Expresses de Propriedades.

Tarefa 4: Testando o pacote de tutorial da Lio 3

Em tempo de execuo, o pacote ir obter o valor da propriedade Directory de uma varivel atualizada em tempo de execuo, ao invs de utilizar o nome original de diretrio que foi especificado quando voc criou o pacote. O valor da varivel populado pelo arquivo SSISTutorial.dtsConfig. Para verificar se, em tempo de execuo, o pacote atualizou corretamente o Diretrio com o novo valor, simplesmente execute o pacote. Devido a serem copiados apenas trs arquivos de dados de exemplo para o novo diretrio, o fluxo de dados ir executar apenas trs vezes ao invs de interagir com 14 arquivos da pasta original. Verificando o layout do pacote

Antes de testar o pacote deve-se verificar se os fluxos de controle e de dados do pacote da Lio 3 contm os objetos mostrados nos diagramas a seguir. O fluxo de controle deve ser idntico ao fluxo de controle da lio 2. O fluxo de dados deve ser idntico ao fluxo de dados das lies 1 e 2. Fluxo de Controle

Fluxo de Dados

Para testar o pacote de tutorial da Lio 3

1. No menu Depurar, clique em Iniciar Depurao. 2. Terminada a execuo do pacote, no menu Depurar, clique em Parar Depurao.

Lio 4: Adicionando log

O Microsoft Integration Services inclui recursos de log que permite que voc solucione problemas e monitore a execuo do pacote ao fornecer um rastreamento de eventos de tarefa e continer. Os recursos de log so flexveis, e podem ser habilitados no nvel do pacote ou em tarefas individuais e contineres dentro do pacote. Voc pode selecionar quais eventos quer voc anotar, e criar mltiplos logs vrios em um nico pacote. O log fornecido por um provedor de log. Cada provedor de log pode escrever informaes de log em diferentes formatos e tipos de destino. O Integration Services fornece os seguintes provedores de log: Arquivo de texto SQL Server Profiler Janela Evento de Log SQL Server Arquivo XML

Nesta lio, voc ir criar uma cpia do pacote que criou em Lio 3: Adicionando configuraes de pacote. Trabalhando com este novo pacote, voc ir adicionar e ento configurar o log para monitorar eventos especficos durante a execuo de pacote. Se voc no tiver completado nenhuma das anteriores lies, poder tambm copiar o pacote da Lio 3 terminada, que est inclusa no tutorial. Tarefas da lio

Esta lio contm as seguintes tarefas: Tarefa 1: Copiando o pacote da Lio 3 Tarefa 2: Adicionando e configurando registro em log Tarefa 3: Testando o pacote de tutorial da Lio 4

Tarefa 1: Copiando o pacote da Lio 3

Nesta tarefa, voc criar uma cpia do pacote Lesson 3.dtsx criado na Lio 3. Como alternativa, possvel adicionar o pacote concludo da Lio 3 includo com o tutorial do projeto e copi-lo. Voc usar esta cpia nova ao longo de toda a Lio 4. Como as informaes de configurao do pacote so copiadas junto com o prprio pacote, voc tambm deve modificar a configurao do pacote para reverter uma das alteraes feitas na lio anterior e apontar o Loop Foreach de volta para a pasta Dados de Exemplo original. Para criar o pacote da Lio 4

1. Se o Business Intelligence Development Studio ainda no estiver aberto, clique em Iniciar, aponte para Todos os Programas, aponte para Microsoft SQL Server e clique em Business Intelligence Development Studio. 2. No menu Arquivo, clique em Abrir, clique em Projeto/Soluo, selecione Tutorial do SSIS, clique em Abrir e clique duas vezes em SSIS Tutorial.sln. 3. No Gerenciador de Solues, clique com o boto direito do mouse em Lesson 3.dtsx e clique em Copiar. 4. No Gerenciador de Solues, clique com o boto direito do mouse em Pacotes SSIS e clique em Colar. Por padro, o pacote copiado recebe o nome de Lesson 4.dtsx. 5. No Gerenciador de Solues, clique duas vezes em Lesson 4.dtsx para abrir o pacote. 6. Clique com o boto direito do mouse em qualquer local do plano de fundo da guia Fluxo de Controle e clique em Propriedades. 7. Na janela Propriedades, atualize a propriedade Name para Lio 4. 8. Clique na caixa da propriedade ID e, na lista, clique em <Gerar Nova ID>. Para adicionar o pacote concludo da lio 3

1. Abra o Business Intelligence Development Studio e abra o projeto do Tutorial do SSIS. 2. No Gerenciador de Solues, clique com o boto direito do mouse em Pacotes SSIS e clique em Adicionar Pacote Existente. 3. Na caixa de dilogo Adicionar Cpia do Pacote Existente, em Local do Pacote, selecione Sistema de Arquivos. 4. Clique no boto de navegao (...), navegue at C:\Arquivos de Programas\Microsoft SQL Server\100\Exemplos\Integration Services\Tutorial\Criando um pacote ETL simples\Pacotes Concludos, selecione Lesson 3.dtsx e clique em Abrir. 5. Copie e cole o pacote da lio 3 conforme descrito nas etapas de 3 a 8 do procedimento anterior. Para modificar a configurao do pacote

1. No Bloco de notas ou em qualquer outro editor de texto, localize e abra o arquivo de configurao SSISTutorial.dts criado usando o Assistente para configurao de pacote na lio anterior. Se estiver comeando a partir desta lio e no tiver criado um arquivo de configurao, poder usar o arquivo de configurao localizado na pasta c:\Arquivos de Programas\SQL Server\100\Exemplos\Integration Services/Tutorial/Criando um pacote ETL simples\Pacotes Concludos. 2. Retorne o valor do elemento Valor Configurado para a pasta de dados de exemplo original. Por padro, a pasta de exemplos est instalada na pasta C:\Arquivos de Programas\Microsoft SQL Server\100\Exemplos\Integration Services\Tutorial\Criando

um pacote ETL simples\Dados de Exemplo. Se estiver comeando a partir desta lio e no tiver modificado este arquivo anteriormente, no precisar fazer alteraes.
Observao: No necessrio colocar o caminho entre aspas no arquivo de configurao XML.

3. Salve a alterao e feche o editor de textos.

Tarefa 2: Adicionando e configurando registro em log

Nesta tarefa voc ativar o log para o fluxo de dados do pacote Lio 4. Ento, voc configurar um provedor de log de arquivo de texto para armazenar os eventos PipelineExecutionPlan e PipelineExecuteTrees em log. O provedor de log de arquivos de texto cria logs que so fceis exibir e transportar. A simplicidade destes arquivos de log faz estes arquivos especialmente teis durante a fase de teste bsico de um pacote. possvel tambm exibir as entradas de log na janela Eventos de Log do Designer SSIS. Adicionar log ao pacote

1. No menu SSIS, clique em Registro. 2. Na caixa de dilogo Configurar SSIS Logs, no painel Contineres, certifique-se que o objeto mais alto, que representa o pacote Lio 4, est selecionado. 3. Na guia Provedores e Logs, na caixa Tipo de provedor, selecione SSIS provedor de log para Arquivos de Texto, e clique Adicionar. O Integration Services adiciona um novo provedor de log para arquivos de texto para o pacote, com o nome padro SSIS provedor de logo para arquivos de texto. Agora possvel configurar o novo provedor de log. 4. Na coluna Nome, digite Lesson 4 Log File. 5. Opcionalmente, modifique a Descrio. 6. Na coluna Configurao, clique em <Nova Conexo> para especificar o destino para o qual as informaes de log so gravadas. Na caixa de dilogo Editor do Gerenciador de Conexes de Arquivos, para Tipo de uso, selecione Criar Arquivo e clique em Procurar. Por padro, a caixa de dilogo Selecione Arquivo abrir a pasta do projeto, mas voc pode salvar o log em qualquer localizao. 7. Na caixa de dilogo Selecionar Arquivo, em Nome do Arquivo digite TutorialLog.log, e clique em Abrir. 8. Clique em OK para fechar a caixa de dilogo Editor do Gerenciador de Conexes de Arquivos. 9. No painel Contineres, expandir todos os ns da hierarquia do continer do pacote, e limpe todas as caixas de seleo, inclusive a caixa de seleo Extrair Dados de Exemplo de Moeda. Agora marque a caixa de seleo Extrair Dados de Exemplo de Moeda para adquirir s os eventos para este n.
Importante: Se o estado da caixa de seleo Extrair Dados de Exemplo de Moeda estiver esmaecido ao invs de marcada, a tarefa usar as configuraes de log do continer pai e no ser possvel ativar os eventos de log especficos para a tarefa.

10. Na guia Detalhes, na coluna Eventos, selecione os eventos PipelineExecutionPlan e PipelineExecutionTrees. 11. Clique em Avanado para revisar os detalhes que o provedor de log escrever no log para cada evento. Por padro, todas as categorias de informaes so selecionadas automaticamente para os eventos especificados por voc. 12. Clique em Bsico para ocultar as categorias de informaes. 13. Na guia Provedor e Logs, na coluna Nome, selecione Arquivo de Log da Lio 4. Assim que tiver criado um provedor de log para seu pacote, poder, como opo, retirar a seleo para temporariamente desligar o registro em log, sem ter que excluir e recriar o provedor de log. 14. Clique em OK.

Tarefa 3: Testando o pacote de tutorial da Lio 4

Nesta tarefa, voc executar o pacote Lesson4.dtsx. Quando o pacote for executado, a janela Eventos de Log listar as entradas de log gravadas no arquivo de log. Aps a execuo do pacote ser concluda, voc verificar o contedo do arquivo de log gerado pelo provedor do log. Verificando o layout do pacote

Antes de testar o pacote, recomendvel verificar se os fluxos de controle e de dados do pacote da Lio 4 contm os objetos mostrados nos diagramas a seguir. O fluxo de controle deve ser idntico ao fluxo de controle das lies 2 e 3. O fluxo de dados deve ser idntico ao fluxo de dados nas lies 1 a 3. Fluxo de controle

Fluxo de dados

Para executar o pacote de tutorial da lio 4

1. No menu SSIS, clique em Eventos de Log. 2. No menu Depurar, clique em Iniciar Depurao. 3. Terminada a execuo do pacote, no menu Depurar, clique em Parar Depurao.

Para examinar o arquivo de log gerado

Com o bloco de notas ou qualquer outro editor de texto, abra o arquivo TutorialLog.log. Embora as semnticas das informaes geradas para os eventos PipelineExecutionPlan e PipelineExecutionTrees estejam alm do escopo deste tutorial, voc pode ver que a primeira linha lista os campos de informaes especificados na guia Detalhes da caixa de dilogo Configurar Logs de SSIS. Alm disso, possvel verificar se os dois eventos selecionados, PipelineExecutionPlan e PipelineExecutionTrees, foram conectados para cada iterao do Loop Foreach. Para obter mais informaes sobre como trabalhar com arquivos de log, consulte Implementando logs em pacotes.

Lio 5: Adicionando redirecionamento de fluxo de erro

Para tratar erros que podem ocorrer no processo de transformao, o Microsoft Integration Services fornece a capacidade de decidir, em termos de componente e coluna, como tratar dados que no podem ser transformados. Voc pode escolher ignorar uma falha em determinadas colunas, redirecionar toda a linha com falha ou apenas causar falha no componente. Por padro, todos os componentes no Integration Services so configurados para falhar quando ocorrerem erros. Causar falha em um componente, por sua vez, faz com que o pacote falhe e todo o processamento subseqente pare. Em vez de permitir que as falhas interrompam a execuo do pacote, bom configurar e tratar erros de processamento em potencial conforme ocorrem dentro da transformao. Como voc pode escolher ignorar as falhas para garantir que seu pacote seja executado com xito, freqentemente melhor redirecionar a linha com falhas para outro caminho de processamento, em que os dados e o erro podem ser persistentes, examinados e reprocessados posteriormente. Nesta lio, voc criar uma cpia do pacote desenvolvido em Lio 4: Adicionando log. Ao trabalhar com este pacote novo, voc criar uma verso corrompida de um dos arquivos de dados de exemplo. O arquivo corrompido forar a ocorrncia de um erro de processamento quando voc executar o pacote. Para tratar os dados de erro, voc adicionar e configurar um destino de Arquivo Simples que gravar qualquer linha que no localize um valor de pesquisa na transformao Pesquisa de Cdigos de Moeda em um arquivo. Antes que os dados de erro sejam gravados em um arquivo, voc incluir um componente Script que utiliza script para obter as descries de erro. Voc reconfigurar, ento, a transformao Pesquisa de Cdigos de Moeda para redirecionar qualquer dado que no possa ser processado para a transformao Script. Tarefas da lio

Esta lio contm as seguintes tarefas: Tarefa 1: Copiando o pacote da Lio 4 Tarefa 2: Criando um arquivo corrompido Tarefa 3: Adicionando redirecionamento de fluxo de erro Tarefa 4: Adicionando um destino de arquivo simples Tarefa 5: Testando o pacote de tutorial da Lio 5

Tarefa 1: Copiando o pacote da Lio 4

Nesta tarefa, voc criar uma cpia do pacote Lesson 4.dtsx criado na Lio 4. Se voc no tiver completado a lio 4, poder adicionar o pacote completo da lio 4, includo no tutorial do projeto, e ento trabalhar com uma cpia. Voc usar esta cpia nova ao longo de toda a lio 5. Para criar o pacote da lio 5

1. Se o Business Intelligence Development Studio ainda no estiver aberto, clique em Iniciar, aponte para Todos os Programas, aponte para Microsoft SQL Server e clique em Business Intelligence Development Studio. 2. No menu Arquivo, clique em Abrir, clique em Projeto/Soluo, selecione Tutorial do SSIS, clique em Abrir e clique duas vezes em SSIS Tutorial.sln. 3. No Gerenciador de Solues, clique com o boto direito do mouse em Lesson 4.dtsx e, em seguida, clique em Copiar. 4. No Gerenciador de Solues, clique com o boto direito do mouse em Pacotes SSIS e clique em Colar. Por padro, o pacote copiado recebe o nome de Lesson 5.dtsx. 5. No Gerenciador de Solues, clique duas vezes no pacote Lesson 5.dtsx para abri-lo. 6. Clique com o boto direito do mouse no plano de fundo da guia Fluxo de Controle e clique em Propriedades. 7. Na janela Propriedades, atualize a propriedade Name para Lio 5. 8. Clique na caixa da propriedade ID e, na lista, clique em <Gerar Nova ID>. Para adicionar o pacote concludo da lio 4

1. Abra o Business Intelligence Development Studio e abra o projeto do Tutorial do SSIS. 2. No Gerenciador de Solues, clique com o boto direito do mouse em Pacotes SSIS e clique em Adicionar Pacote Existente. 3. Na caixa de dilogo Adicionar Cpia do Pacote Existente, em Local do Pacote, selecione Sistema de Arquivos. 4. Clique no boto de navegao (...), navegue para C:\Arquivos de Programas\Microsoft SQL Server\100\Exemplos\Integration Services\Tutorial\Criando um tutorial de pacote ETL simples\Pacotes Concludos, selecione Lesson 4.dtsx e, em seguida, clique em Abrir. 5. Copie e cole o pacote da Lio 4 conforme descrito nas etapas de 3 a 8 do procedimento anterior.

Tarefa 2: Criando um arquivo corrompido

Para demonstrar a configurao e o tratamento de erros de transformao, voc ter que criar um arquivo simples de amostra que no processamento causa a falha de um componente. Nesta tarefa, voc criar uma cpia de um arquivo simples de amostra existente. Voc dever ento abrir o arquivo no Bloco de Notas e editar a coluna CurrencyID para certificar-se de que no produzir uma correspondncia durante a pesquisa de transformaes. Quando o arquivo novo for processado, a falha na pesquisa ir causar a falha da transformao Pesquisa de Cdigos de Moeda e criar, portanto, uma falha no resto do pacote. Depois de criar o arquivo de amostra corrompido, voc executar o pacote para exibir a falha do pacote. Para criar um arquivo simples de amostra corrompido

1. No Bloco de Notas ou em qualquer outro editor de texto, abra o arquivo Currency_VEB.txt. Por padro, o arquivo Currency_VEB.txt instalado na pasta C:\Arquivos de Programas\Microsoft SQL Server\100\Samples\Integration Services\Tutorial\Creating a Simple ETL Package\Sample Data. 2. Use o recurso de localizar e substituir do editor de texto para encontrar todas as instncias de VEB e substitu-los por BAD. 3. Na mesma pasta dos outros arquivos de dados de exemplo, salve o arquivo modificado como Currency_BAD.txt.
Importante: Certifique-se de que o arquivo Currency_BAD.txt ser salvo na pasta c:\Arquivos de Programas\Microsoft SQL Server\100\Samples\Integration Services\Tutorial\Creating a Simple ETL Package\Sample Data.

4. Feche seu editor de texto. Para verificar se um erro acontecer durante o tempo de execuo

1. No menu Depurar, clique em Iniciar Depurao. Na terceira repetio do fluxo de dados, uma transformao Pesquisa de Cdigos de Moeda tenta processar o arquivo Currency_BAD.txt e a transformao ir falhar. O fracasso da transformao far o pacote inteiro falhar. 2. No menu Depurar, clique em Parar Depurao. 3. Na superfcie de design, clique na guia Resultados da Execuo. 4. Procure no log e verifique se o seguinte erro sem tratamento ocorreu: [Lookup Currency Key[30]] Error: Row yielded no match during lookup. Observao:

O nmero 30 a ID do componente. Esse valor atribudo quando voc cria o fluxo de dados, ou seja, o v pacote pode ser diferente.

Tarefa 3: Adicionando redirecionamento de fluxo de erro

Conforme mostrado na tarefa anterior, a transformao Pesquisa de Cdigos de Moeda no pode gerar uma correspondncia quando a transformao tenta processar o arquivo simples de amostra corrompido que produziu um erro. Como a transformao usa as configuraes padro da sada de erro, qualquer erro faz a transformao falhar. Quando a transformao falha, o resto do pacote tambm falha. Em vez de permitir a falha da transformao, voc pode configurar o componente para redirecionar a linha com falha para outro caminho de processamento usando a sada de erro. O uso de um caminho de tratamento separado de erro permite que voc faa vrias coisas. Por exemplo, voc pode tentar limpar os dados e depois reprocessar a linha com falha. Tambm possvel salvar a linha com falha junto com informaes de erro adicionais para verificao e reprocessamento posteriores. Nesta tarefa, voc configurar a transformao Pesquisa de Cdigos de Moeda para redirecionar linhas com falha para a sada de erro. Na ramificao de erro do fluxo de dados, essas filas sero gravadas em um arquivo. Por padro as duas colunas extras em uma sada de erro do Integration Services, ErrorCode e ErrorColumn, s contm cdigos numricos que representam um nmero de erro e a ID da coluna na qual o erro aconteceu. Esses valores numricos podem ser de uso limitado sem a descrio de erro correspondente. Para aumentar a utilidade da sada de erro, antes de o pacote gravar as linhas com falha no arquivo, voc usar um componente Script para acessar a API do Integration Services e obter uma descrio do erro. Para configurar uma sada de erro

1. Na Caixa de Ferramentas, expanda Transformaes de Fluxo de Dados e depois arraste o Componente Script para a superfcie de design da guia Fluxo de Dados. Coloque Script direita da transformao Pesquisa de Cdigos de Moeda. 2. Na caixa de dilogo Selecionar Tipo de Componente do Script, clique em Transformao e clique em OK. 3. Clique na transformao Pesquisa de Cdigos de Moeda e depois arraste a seta vermelha sobre a transformao Scripts adicionada recentemente para conectar os dois componentes. A seta vermelha representa a sada de erro da transformao Pesquisa de Cdigos de Moeda. Usando a seta vermelha para conectar a transformao ao componente Script, voc pode redirecionar qualquer erro de processamento ao componente Script, que ento processar os erros e os enviar ao destino. 4. Na caixa de dilogo Configurar Sada de Erro, na coluna Erro, selecione Redirecionar linha e, em seguida, clique em OK. 5. Na superfcie de design de Fluxo de Dados, clique em Componente Script, no recm-adicionado ComponenteScript, e altere o nome para Obter Descrio de Erro. 6. Clique duas vezes na transformao Obter Descrio do Erro. 7. Na caixa de dilogo Editor de Transformao Scripts, na pgina Colunas de Entrada, selecione a coluna ErrorCode. 8. Na pgina Entradas e Sadas, expanda Sada 0, clique em Colunas de Sada e clique em Adicionar Coluna. 9. Na propriedade Name, digite ErrorDescription e defina a propriedade DataType como cadeia de caracteres [DT_WSTR].

10. Na pgina Script, verifique se a propriedade LocaleID est definida como Ingls (Estados Unidos). 11. Clique em Editar Script para abrir o Microsoft Visual Studio Tools for Applications (VSTA). No mtodo Input0_ProcessInputRow, digite ou cole o cdigo a seguir. [Visual Basic] Row.ErrorDescription = Me.ComponentMetaData.GetErrorDescription(Row.ErrorCode) [Visual C#] Row.ErrorDescription this.ComponentMetaData.GetErrorDescription(Row.ErrorCode); A sub-rotina concluda se parecer com o cdigo a seguir. [Visual Basic] Public Overrides Sub Input0_ProcessInputRow(ByVal Row As Input0Buffer) Row.ErrorDescription = Me.ComponentMetaData.GetErrorDescription(Row.ErrorCode) End Sub [Visual C#] public override void Input0_ProcessInputRow(Input0Buffer Row) { Row.ErrorDescription this.ComponentMetaData.GetErrorDescription(Row.ErrorCode); } 12. Crie o script para salvar suas alteraes e depois feche o VSTA. 13. Clique em OK para fechar a caixa de dilogo Editor de Transformao Scripts. = =

Tarefa 4: Adicionando um destino de arquivo simples

A sada de erro da transformao Pesquisa de Cdigos de Moeda redireciona para a transformao Script todas as linhas de dados que falharam na operao de pesquisa. Para aprimorar as informaes sobre os erros que ocorreram, a transformao Script executa um script que adquire a descrio de erros. Nessa tarefa, voc salvar todas essas informaes sobre as linhas com falha em um arquivo delimitado, para processamento posterior. Para salvar as linhas com falha, voc deve adicionar e configurar um gerenciador de conexes de arquivo simples para o arquivo de texto que conter os dados de erro e um arquivo simples de destino. Ao definir propriedades no gerenciador de conexes de arquivo simples que o arquivo simples usa, voc pode especificar como o destino do arquivo simples formata e escreve o arquivo de texto. Para adicionar e configurar um destino de arquivo simples

1. Clique na guia Fluxo de Dados. 2. Na Caixa de Ferramentas, expanda Destinos de Fluxo de Dados e arraste Destino de Arquivo Simples sobre a superfcie de design de fluxo de dados. Coloque Destino de Arquivo Simples diretamente embaixo da transformao Obter Descrio do Erro. 3. Clique na transformao Obter Descrio do Erro e arraste a seta verde sobre o novo Destino de Arquivo Simples. 4. Na superfcie de design de Fluxo de Dados, clique em Destino de Arquivo Simples, na recm-adicionada transformao Destino de Arquivo Simples, e altere o nome para Linhas com Falha. 5. Clique com o boto direito do mouse na transformao Linhas com Falha, clique em Editar e, em seguida, no Editor de Destino de Arquivo Simples, clique em Novo. 6. Na caixa de dilogo Formato de Arquivo Simples, verifique se Delimitado est selecionado e depois clique em OK. 7. No Editor do Gerenciador de Conexes de Arquivos Simples, no tipo de caixa Nome do Gerenciador de Conexes digite Dados do Erro. 8. Na caixa de dilogo Editor do Gerenciador de Conexes de Arquivo Simples, clique em Procurar e localize a pasta em que o arquivo ser armazenado. 9. Na caixa de dilogo Abrir, para tipo de Nome do arquivo, digite ErrorOutput.txt e depois clique em Abrir. 10. Na caixa de dilogo Editor do Gerenciador de Conexes de Arquivo Simples, verifique se a caixa Localidade contm Ingls (Estados Unidos) e Pgina de cdigo contm 1252 (ANSI - Latin I). 11. No painel de opes, clique em Colunas. Observe que, alm das colunas do arquivo de dados de origem, trs colunas novas esto presentes: ErrorCode, ErrorColumn e ErrorDescription. Essas colunas so geradas pela sada de erro da transformao Pesquisa de Cdigos de Moeda e pelo script na transformao Obter Descrio do Erro e podem ser usadas para diagnosticar a causa da linha com falha. 12. Clique em OK. 13. No Editor de Destino de Arquivo Simples, desmarque a caixa de seleo Substituir dados no arquivo. Ao desmarcar essa caixa de seleo, os erros sobre as execues de vrios pacotes sero mantidos.

14. No Editor de Destino de Arquivo Simples, clique em Mapeamentos para verificar se todas as colunas esto corretas. Como alternativa, voc pode renomear as colunas no destino. 15. Clique em OK.

Tarefa 5: Testando o pacote de tutorial da Lio 5

No tempo de execuo, o arquivo corrompido, Currency_BAD.txt, no gerar uma correspondncia dentro da transformao Pesquisa de Cdigos de Moeda. Como a sada de erro de Pesquisa de Cdigos de Moeda foi configurada para redirecionar linhas com falhas para o novo destino de linhas com falha, o componente no falha e o pacote executado com xito. Todas as linhas com erro so gravadas em ErrorOutput.txt. Nesta tarefa, voc testar a configurao de sada do erro revisado executando o pacote. Com a execuo bem-sucedida do pacote, voc ver o contedo do arquivo ErrorOutput.txt.
Observao: Se voc no quiser acumular linhas de erro no arquivo ErrorOutput.txt, exclua manualmente o contedo do arquivo entre execues de pacotes.

Verificando o layout do pacote

Antes de voc testar o pacote, recomendvel verificar se o fluxo de controle e o fluxo de dados do pacote da lio 5 contm os objetos mostrados nos diagramas seguintes. O fluxo de controle deve ser idntico ao fluxo de controle das lies 2 - 4. Fluxo de controle

Fluxo de dados

Para executar o pacote de tutorial da lio 5

1. No menu Depurar, clique em Iniciar Depurao. 2. Terminada a execuo do pacote, no menu Depurar, clique em Parar Depurao. Para verificar o contedo do arquivo ErrorOutput.txt

No Bloco de Notas ou qualquer outro editor de texto, abra o arquivo ErrorOutput.txt. A ordem de colunas padro : AverageRate, CurrencyID, CurrencyDate, EndOfDateRate, ErrorCode, ErrorColumn, ErrorDescription. Observe que todas as linhas do arquivo contm o valor CurrencyID de BAD, o valor ErrorCode de -1071607778, o valor ErrorColumn de 0 e o valor ErrorDescription de "Row yielded no match during lookup." O valor de ErrorColumn definido como 0 porque o erro no especfico da coluna. A operao de pesquisa que falhou. .