Componente di esempio DatasetDestination

Articolo
12/15/2008

L'esempio DatasetDestination illustra come implementare un componente di destinazione personalizzato integrato in Business Intelligence Development Studio e aggiungerlo a un'attività Flusso di dati. Il componente archivia le righe ricevute durante l'esecuzione in un set di dati. Al termine dell'esecuzione, a seconda della configurazione del componente, il set di dati viene assegnato a una variabile di run-time e può essere salvato in un file XML. Il file XML creato dal set di dati può essere utilizzato come origine XML. Questa struttura consente di salvare i risultati di una esecuzione del flusso di dati esternamente e di utilizzarli come origine di un altro componente. Questo esempio non è supportato nei sistemi operativi basati su processori Itanium.

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.

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.

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 i componenti seguenti siano installati.

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

Percorso

Se l'esempio di codice viene installato nella posizione predefinita, l'esempio si trova nella directory seguente:

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

La versione C# dell'esempio di codice si trova nella directory CS, mentre la versione 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

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.
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 <system_drive>:\Programmi\Microsoft SQL Server\90\Samples.
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

Scegliere Apri dal menu File, fare clic su Progetto e aprire DataSetDestination.sln nel linguaggio di programmazione desiderato.
Scegliere Genera DatasetDestination 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 generato 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

Aprire Esplora risorse o l'applicazione desiderata per le operazioni nel file system.
Copiare l'assembly (DatasetDestinationCS.dll o DatasetDestinationVB.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

Aprire Esplora risorse o l'applicazione desiderata per le operazioni nel file system.
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

Aprire la finestra del prompt dei comandi.
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\DataSetDestinationCS.dll "

- or -

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\DataSetDestinationVB.dll "

Per aggiungere il componente alla casella degli strumenti

Aprire Business Intelligence Development Studio.
Fare clic con il pulsante destro del mouse sulla casella degli strumenti e quindi scegliere Scegli elementi.
Nella finestra di dialogo Scegli elementi della Casella degli strumenti fare clic sulla scheda Elementi flusso di dati SSIS.
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 di esempio a un'attività Flusso di dati in un pacchetto, è possibile configurarlo in Progettazione SSIS. Il componente DataSetDestination ha tre proprietà personalizzate che ne controllano l'esecuzione. L'esecuzione del componente ha esito positivo se si lasciano invariati i valori predefiniti delle proprietà. In questo caso, il set di dati non viene salvato al termine dell'esecuzione.

Proprietà	Descrizione
RuntimeVariable	Specifica il nome di una variabile di run-time in cui viene scritto il set di dati dopo l'esecuzione.
DataTableName	Specifica il nome della tabella DataTable creata (per un nuovo set di dati) o aggiunta (per un set di dati esistente).
SaveDataSetToXml	Specifica se il set di dati viene salvato in un file XML al termine dell'esecuzione. Se il valore di questa proprietà è impostato su true, è necessario specificare una gestione connessione file per il componente.

Condividi tramite