Share via

Readme_Exemplo do componente Remover Duplicatas com Interface de Usuário

  • Artigo

Esse exemplo funciona apenas com o SQL Server 2005 e o SQL Server 2008. Ele não funcionará com nenhuma versão do SQL Server anterior ao SQL Server 2005.

O exemplo Remover Duplicatas demonstra a implementação de um componente de transformação de fluxo de dados com saídas assíncronas. Componentes com saídas assíncronas recebem uma entrada PipelineBuffer e uma saída PipelineBuffer que correspondem à entrada e à saída do objeto. Os buffers de entrada contêm linhas fornecidas por componentes upstream. O buffer de saída está vazio e é preenchido pelo componente usando, geralmente, as linhas do buffer de entrada durante uma chamada ao método ProcessInput. Depois que todas as linhas forem recebidas, elas serão classificadas; as linhas diferentes serão enviadas para uma saída e as linhas duplicadas para outra.

Dica

Para obter mais informações sobre componentes com saídas assíncronas, consulte "Criando um componente de transformação com saídas assíncronas" nos Manuais Online do SQL Server.

Este exemplo não tem suporte em sistemas operacionais com base no Itanium.

Importante

Os exemplos de código de Programação de Fluxo de Dados do Integration Services destinam-se a demonstrar a funcionalidade básica que você deve implementar para criar um componente de fluxo de dados personalizado. Os exemplos não incluem suporte completo para personalização no Editor Avançado. Por exemplo, você não pode usar o Editor Avançado para adicionar ou remover entradas e saídas ou configurar colunas.

Os exemplos são fornecidos somente para fins educativos. Eles não devem ser usados em um ambiente de produção nem foram testados nesse tipo de ambiente. A Microsoft não fornece suporte técnico para esses exemplos.

Executando o exemplo

Se você já souber como localizar, criar e instalar exemplos de código, poderá ir diretamente para a seção Testando o exemplo e ler sobre como configurar e executar o exemplo de código.

Pré-requisitos

Esse exemplo requer que os seguintes componentes sejam instalados.

  • Microsoft Visual Studio
  • Microsoft SQL Server Integration Services

Local

Se os exemplos de código foram instalados no local padrão de instalação, a versão C# do exemplo de código estará na seguinte pasta:

C:\Arquivos de Programas\Microsoft SQL Server\100\Samples\Integration Services\Programming Samples\Data Flow\RemoveDuplicatesWithUI Component Sample\CS

Dica

A versão do exemplo Remover Duplicatas que inclui uma interface do usuário personalizada só é fornecida na linguagem de programação C# .

Para obter informações sobre o processo de duas etapas necessário para instalar os exemplos, consulte Considerações para instalar exemplos e bancos de dados de exemplo do SQL Server.

Criando o exemplo

Se você ainda não gerou um arquivo de chave de nome forte na pasta Exemplos, use o procedimento a seguir para gerar esse arquivo. Os projetos de exemplo são configurados para assinar assemblies no momento da criação com este arquivo de chave. Você pode exibir as propriedades de assinatura na guia Assinatura da caixa de diálogo Propriedades do Projeto.

Para gerar um arquivo de chave de nome forte

  1. Para abrir um prompt de comando do Microsoft Visual Studio, clique em Iniciar, aponte para Todos os Programas, Microsoft Visual Studio 2008, Visual Studio Tools e clique em Prompt de comando do Visual Studio 2008.

    - ou -

    Para abrir um prompt de comando do Microsoft .NET Framework, clique em Iniciar, aponte para Todos os Programas, Microsoft .NET Framework SDK 2.0 e clique em Prompt de Comando do SDK.

  2. No prompt de comando, use o comando CD (alterar diretório) para alterar a pasta atual da janela Prompt de Comando para a pasta Exemplos. O arquivo de chave que você criar nessa pasta será usado por todos os exemplos de código do SQL Server.

    Dica

    Para determinar a pasta onde se encontram os exemplos, clique em Iniciar, aponte para Todos os Programas, Microsoft SQL Server 2008, Documentação e Tutoriais e clique em Diretório de Exemplos. Se o local de instalação padrão tiver sido usado, os exemplos estarão localizados em <unidade>:\Arquivos de Programas\Microsoft SQL Server\100\Samples.

  3. No prompt de comando, execute o seguinte comando para gerar o arquivo de chave:

    sn -k SampleKey.snk

    Importante

    Para obter mais informações sobre um par de chaves de nome forte, consulte "Resumos de segurança: nomes fortes e segurança no .NET Framework" no .NET Development Center do MSDN.

  4. Você precisará do token de chave pública do arquivo de chave em uma etapa subseqüente. Para obter o token de chave pública, extraia primeiro a chave pública do arquivo de chave para um novo arquivo executando o seguinte comando no prompt de comando:

    sn -p SampleKey.snk SampleKeyPublic.snk

    Agora, exiba o token de chave pública do novo arquivo executando o seguinte comando no prompt de comando:

    sn -t SampleKeyPublic.snk

  5. Copie o token de chave pública na área de transferência ou salve-o para uso posterior.

Para criar o exemplo no Microsoft Visual Studio 2008

  1. No menu Arquivo | Abrir, clique em Projeto e abra RemoveDuplicatesWithUI.sln.

  2. Localize o atributo DtsPipelineComponent antes da declaração de classe no arquivo RemoveDuplicates.cs ou RemoveDuplicates.vb e substitua o valor alfanumérico do Token de Chave Pública na propriedade UITypeName do atributo pelo token de chave pública obtido anteriormente do arquivo de chave.

  3. No menu Criar, clique em Criar RemoveDuplicatesWithUI para criar a solução.

Instalando o exemplo

Esse exemplo só é fornecido em C#. Depois de criar com êxito o componente, siga estas etapas para adicioná-lo a uma tarefa Fluxo de Dados no Business Intelligence Development Studio.

Para copiar o componente para a pasta PipelineComponents

  1. Abra o Windows Explorer ou o aplicativo de sua preferência para trabalhar no sistema de arquivos.

  2. Copie o assembly (RemoveDuplicatesWithUICS.dll) para a pasta PipelineComponents localizada em %system%\Arquivos de Programas\Microsoft SQL Server\100\DTS.

Para instalar o componente no GAC (cache de assembly global) arrastando o assembly

  1. Abra o Windows Explorer ou o aplicativo de sua preferência para trabalhar no sistema de arquivos.

  2. Arraste o assembly da pasta PipelineComponents para a pasta onde o GAC está localizado, em %system%\assembly.

Para instalar o componente no GAC usando gacutil.exe

  1. Abra uma janela do prompt de comando.

  2. Digite o seguinte comando para executar gacutil.exe e instalar a versão C# do componente no GAC:

    gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\100\DTS\PipelineComponents\RemoveDuplicatesWithUICS.dll "

Para adicionar o componente à Caixa de Ferramentas

  1. Abra o Business Intelligence Development Studio.

  2. Clique com o botão direito do mouse na caixa de ferramentas e clique em Escolher Itens.

  3. Na caixa de diálogo Escolher Itens da Caixa de Ferramentas, clique na guia Itens de Fluxo de Dados SSIS.

  4. Clique na caixa de seleção de seu componente e clique em OK.

    Dica

    Se o componente não for exibido na lista, clique em Procurar para localizar o componente. Nesse caso, talvez ele não seja instalado corretamente.

Depois de concluir essas etapas, o componente estará visível na guia Itens de Fluxo de Dados da Caixa de Ferramentas e poderá ser adicionado à tarefa Fluxo de Dados no Designer SSIS.

Testando o exemplo

Depois de adicionar o componente de exemplo à tarefa Fluxo de Dados e conectá-lo a um componente que fornecerá dados a ele, você poderá configurá-lo como consta no Designer SSIS.

Para configurar o componente de exemplo em um pacote

  • Selecione as colunas a serem usadas pelo componente no editor personalizado do componente. Somente as colunas selecionadas são passadas para o próximo componente no fluxo de dados. O conteúdo de cada coluna é avaliado para determinar se uma linha corresponde a outras linhas.