Esempio di creazione di un pacchetto per l'aggiunta di un flusso di dati

Data aggiornamento: 5 dicembre 2005

L'esempio Create DataFlow Package illustra come creare un pacchetto a livello di programmazione e aggiungere un flusso di dati. Il pacchetto creato in questo esempio esegue le azioni seguenti:

• Estrae i dati dalla tabella Products del database AdventureWorks.
• Crea una variabile per identificare la colonna utilizzata per ordinare l'output.
• Salva i risultati in una destinazione file flat.
• Esegue il pacchetto in memoria.
• Salva il pacchetto per l'analisi successiva.

Importante:
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. Se si utilizzano gli esempi di codice per la prima volta, è consigliabile leggere innanzitutto i prerequisiti.

Prerequisiti

Prima di eseguire il codice di esempio, verificare che vengano soddisfatte le condizioni seguenti:

• Avviare Gestione configurazione SQL Server facendo clic sul pulsante Start, scegliendo Tutti i programmi, Microsoft SQL Server 2005, Strumenti di configurazione e quindi Gestione configurazione SQL Server.
• . Espandere Configurazione di rete SQL Server 2005. Selezionare Protocolli per MSSQLServer. Fare clic con il pulsante destro del mouse su TCP/IP e scegliere Attiva. Arrestare e riavviare il servizio. Per ulteriori informazioni, vedere "Procedura: Impostazione delle proprietà del servizio Integration Services tramite lo snap-in Servizi" nella documentazione in linea di SQL Server.
  Oppure
  Aprire il file main.cs e sostituire il valore localhost assegnato al parametro Source in adventureWorks.ConnectionString con il nome del server in uso.
• L'esempio di codice e i relativi dati di esempio devono innanzitutto essere installati sul disco rigido locale. Per ulteriori informazioni, vedere "Installazione e compilazione degli esempi di programmazione di Integration Services" nella documentazione in linea di SQL Server.
• Aver collegato il database AdventureWorks e disporre delle relative autorizzazioni amministrative. Per ulteriori informazioni, vedere "Installazione dei database di esempio AdventureWorks e degli esempi" nella documentazione in linea di SQL Server.

Per compilare gli esempi di codice è necessario .NET Framework SDK 2.0 o Microsoft Visual Studio 2005. .NET Framework SDK è disponibile gratuitamente. Vedere l'argomento della documentazione in linea Installazione di .NET Framework SDK.

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\Control Flow\CreatePackage 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, attenersi alla procedura seguente per generarlo.

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 Microsoft 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.

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

1. Aprire Microsoft Visual Studio 2005.

2. Scegliere Apri dal menu File, fare clic su Progetto e aprire la soluzione (file con estensione sln) per l'esempio desiderato, ovvero CreatePackageCS.sln nella cartella CS o CreatePackageVB.sln nella cartella VB, in base al linguaggio desiderato.

3. Scegliere Genera CreateTask*<ling>* dal menu Genera.

Test dell'esempio

Quando il codice viene eseguito, il pacchetto creato a livello di programmazione viene eseguito in memoria e salvato sul computer locale.

Per analizzare la versione salvata del pacchetto creato da questo esempio di codice, aprire il pacchetto in Progettazione SSIS. Per ulteriori informazioni su come aprire un pacchetto in Progettazione SSIS, vedere l'argomento "Procedura: Aggiunta di un progetto di Integration Services esistente a una soluzione" nella documentazione in linea di SQL Server 2005.

Il pacchetto viene salvato nel percorso seguente:

C:\Programmi\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\CreatePackage Sample\<language>\CreatePackage\bin\Debug\SampleRuntimePackage.dtsx

I risultati creati dal pacchetto vengono salvati nel percorso seguente:

C:\Programmi\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\CreatePackage Sample\<language>\CreatePackage\bin\Debug\SampleRuntimeData.txt

Per verificare che il pacchetto sia stato eseguito correttamente, esaminare i risultati nel file flat di destinazione. La colonna specificata dalla variabile SortColumn determina la modalità di ordinamento dei risultati. Durante la successiva esecuzione dell'esempio il pacchetto salvato e i risultati precedenti nel file flat vengono sovrascritti.

Durante l'esecuzione le informazioni sullo stato del pacchetto, incluso il numero di righe scritte, vengono inviate alla console. Di seguito è riportato un esempio delle informazioni inviate alla console.

OnInformation

SubComponent: DTS.Pipeline

Description: "componente "FlatFileDestination" (221)" ha scritto 504 righe.

Cronologia modifiche

Versione	Cronologia
17 luglio 2006	Contenuto modificato: Aggiunta di informazioni dettagliate sull'esecuzione e il test del pacchetto, con descrizione dei risultati previsti.