Componente di esempio per la rimozione di duplicati

L'esempio Remove Duplicates illustra l'implementazione di un componente trasformazione del flusso di dati con output asincroni. I componenti con output asincroni ricevono un input e restituiscono il metodo PipelineBuffer in base all'input e all'output dell'oggetto. I buffer di input contengono le righe fornite dai componenti a monte. Il buffer di output è vuoto e viene riempito dal componente, in genere utilizzando le righe del buffer di input, durante una chiamata al metodo ProcessInput. Dopo che sono state ricevute tutte le righe, queste ultime vengono ordinate e le righe distinte vengono inviate a un output, mentre quelle duplicate all'altro. Questo esempio non è supportato in IA64.

Importante:

Gli esempi di codice di programmazione per Flusso di dati Integration Services illustrano le funzionalità di base da implementare per la creazione di un componente flusso di dati personalizzato. Gli esempi non includono il supporto completo per la personalizzazione nell'editor avanzato. Non è ad esempio possibile aggiungere o rimuovere input e output oppure configurare colonne mediante l'editor avanzato. Gli esempi vengono offerti esclusivamente a scopo didattico. Non sono progettati per l'utilizzo in un ambiente di produzione e non sono stati testati in un ambiente di produzione. Microsoft non fornisce servizi di supporto tecnico per questi esempi.

Per ulteriori informazioni sulla creazione di un componente con output asincroni, vedere l'argomento relativo allo sviluppo di un componente di trasformazione personalizzato con output asincroni nella documentazione in linea di SQL Server 2005.

Esecuzione dell'esempio

Se non sono necessarie informazioni sulle procedure per l'individuazione, la generazione e l'installazione degli esempi di codice, è possibile passare direttamente alla sezione Test dell'esempio per informazioni sulla configurazione e l'esecuzione dell'esempio di codice.

Prerequisiti

Per utilizzare questo esempio è necessario che siano installati i componenti seguenti.

• Microsoft Visual Studio 2005
• Microsoft SQL Server 2005 Integration Services

Percorso

Se gli esempi di codice sono stati installati nel percorso di installazione predefinito, la versione C# dell'esempio di codice si trova nella cartella seguente:

C:\Programmi\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Data Flow\RemoveDuplicates Component Sample

La soluzione C# dell'esempio di codice si trova nella directory CS, mentre la soluzione Visual Basic si trova nella directory VB.

Per ulteriori informazioni sul processo in due fasi necessario per l'installazione degli esempi, vedere Installazione degli esempi. Per ottenere la versione più recente degli esempi, inclusi nuovi esempi resi disponibili dopo il rilascio di SQL Server 2005, vedere Esempi e database di esempio di SQL Server 2005 (aprile 2006).

Generazione dell'esempio

Se non è stato ancora generato un file di chiave con nome sicuro nella cartella Samples, attenersi alla procedura seguente per generarlo. I progetti di esempio sono configurati per firmare gli assembly durante la generazione con questo file di chiave. È possibile visualizzare le proprietà della firma nella scheda Firma della finestra di dialogo Proprietà progetto

Per generare un file di chiave con nome sicuro

1. Per aprire il prompt dei comandi di Microsoft Visual Studio 2005, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft Visual Studio 2005, Visual Studio Tools e quindi fare clic su Prompt dei comandi di Visual Studio 2005.

   -oppure-

   Per aprire il prompt dei comandi di Microsoft .NET Framework, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK 2.0 e quindi fare clic su Prompt dei comandi SDK.

2. Al prompt dei comandi mediante il comando CD (change directory) passare dalla directory corrente della finestra del prompt dei comandi alla cartella Samples. Il file di chiave creato in questa cartella verrà utilizzato da tutti gli esempi di codice di SQL Server 2005.

   [!NOTA] Per determinare la cartella in cui si trovano gli esempi, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft SQL Server 2005, Documentazione ed esercitazioni e quindi Directory esempi. Se è stato utilizzato il percorso di installazione predefinito, gli esempi si troveranno in <unità_sistema>:\Programmi\Microsoft SQL Server\90\Samples.

3. Al prompt dei comandi digitare il comando seguente per generare il file di chiave:

   sn -k SampleKey.snk
   

   Importante:
   Per ulteriori informazioni sulla coppia di chiavi con nome sicuro, vedere l'argomento relativo ai nomi sicuri e alla protezione in .NET Framework nel centro per sviluppatori di .NET su MSDN (informazioni in lingua inglese).

Per generare l'esempio in Microsoft Visual Studio 2005

1. Scegliere Apri dal menu File, fare clic su Progetto e aprire RemoveDuplicates.sln nel linguaggio di programmazione desiderato.

2. Scegliere Genera RemoveDuplicates dal menu Genera per generare il progetto.

Installazione dell'esempio

Questo esempio è disponibile in Visual Basic e C#. Per distinguere gli assembly delle due versioni dell'esempio, al nome degli assembly di output sono stati aggiunti i suffissi CS e VB. Dopo aver creato il componente, eseguire le operazioni seguenti per aggiungerlo a un'attività Flusso di dati in Business Intelligence Development Studio.

Per copiare il componente nella cartella PipelineComponents

1. Aprire Esplora risorse o l'applicazione desiderata per le operazioni nel file system.

2. Copiare l'assembly (RemoveDuplicatesCS.dll or RemoveDuplicatesVB.dll) nella cartella PipelineComponents in %system%\Programmi\Microsoft SQL Server\90\DTS.

Per installare il componente nella cache di assembly globale (CAG) trascinando l'assembly

1. Aprire Esplora risorse o l'applicazione desiderata per le operazioni nel file system.

2. Trascinare l'assembly dalla cartella PipelineComponents alla cartella in cui si trova la cache di assembly globale (CAG), nel percorso %system%\assembly.

Per installare il componente nella cache di assembly globale (CAG) tramite gacutil.exe

1. Aprire la finestra del prompt dei comandi.

2. Digitare il comando seguente per eseguire gacutil.exe e installare la versione C# del componente nella cache di assembly globale (CAG):

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

   -oppure-

   Digitare il comando seguente per eseguire gacutil.exe e installare la versione Visual Basic del componente nella cache di assembly globale (CAG):

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

Per aggiungere il componente alla casella degli strumenti

1. Aprire Business Intelligence Development Studio.

2. Fare clic con il pulsante destro del mouse sulla casella degli strumenti e quindi scegliere Scegli elementi.

3. Nella finestra di dialogo Scegli elementi della Casella degli strumenti fare clic sulla scheda Elementi flusso di dati SSIS.

4. Fare clic sulla casella di controllo accanto al componente e quindi scegliere OK.

   [!NOTA] Se il componente non viene visualizzato nell'elenco, scegliere Sfoglia per individuarlo manualmente. In questo caso tuttavia potrebbe non essere stato installato correttamente.

Dopo aver eseguito queste operazioni, il componente è visualizzato nella sezione Elementi flusso di dati SSIS della Casella degli strumenti e può essere aggiunto all'attività Flusso di dati in Progettazione SSIS.

Test dell'esempio

Dopo avere aggiunto il componente a un'attività Flusso di dati in un pacchetto e averlo connesso al componente che fornisce le righe, eseguire le operazioni seguenti per configurarlo in Progettazione SSIS.

Per configurare il componente di esempio in un pacchetto

• Selezionare le colonne che dovranno essere utilizzate dal componente nella scheda Colonne di input dell'editor avanzato. Nel flusso di dati solo le colonne selezionate verranno passate al componente successivo. Il contenuto di ogni colonna viene confrontato per determinare se una riga corrisponde ad altre righe.