Componente di esempio di origine ADO
Il componente di esempio ADO Source illustra come implementare un componente di origine da utilizzare come origine dei dati nell'attività Flusso di dati. Questo componente utilizza la gestione connessione ADO.NET per acquisire una connessione a un database ed esegue l'istruzione SQL fornita dall'utente. Le righe ottenute dall'esecuzione dell'istruzione vengono aggiunte al metodo PipelineBuffer fornito al componente dall'attività Flusso di dati e quindi vengono rese disponibili ai componenti a valle. Questo esempio non è supportato nei sistemi operativi basati su processori Itanium.
.gif "ms161560.note(it-it,SQL.90).gif") 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. |
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\Ado Source 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.snkImportante: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 il file di soluzione AdoSource.sln nel linguaggio di programmazione desiderato.
Scegliere Genera AdoSource 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 la generazione, eseguire la procedura seguente per utilizzare il componente 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 (AdoSourceCS.dll o AdoSourceVB.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\AdoSourceCS.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\AdoSourceVB.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 sarà visualizzato nella sezione Origini flusso di dati della casella degli strumenti e potrà essere aggiunto all'attività Flusso di dati nella finestra di progettazione.
Test dell'esempio
Dopo avere aggiunto il componente di esempio a un'attività Flusso di dati in un pacchetto, è possibile configurarlo in Progettazione SSIS come descritto di seguito.
Per configurare il componente di esempio in un pacchetto
Aggiungere una gestione connessione ADO.NET al pacchetto e selezionare il provider Microsoft OLE DB per SQL Server. Configurare il componente di esempio per l'utilizzo di questa gestione connessione.
Nella pagina Proprietà componente dell'editor avanzato, in Proprietà personalizzate, configurare la proprietà personalizzata SqlStatement del componente immettendo una query SQL valida per le tabelle o le viste del database a cui si connette la gestione connessione.