Share via


Componente script

Il componente script ospita script e consente a un componente di includere ed eseguire codice di script personalizzato. È possibile utilizzare il componente script nei pacchetti per gli scopi seguenti:

  • Applicare più trasformazioni ai dati anziché utilizzare più trasformazioni nel flusso di dati. Uno script può ad esempio sommare i valori in due colonne e quindi calcolare la media della somma.

  • Accedere a regole business in un assembly .NET esistente. Uno script può ad esempio applicare una regola business che specifica l'intervallo dei valori validi in una colonna di nome Income.

  • Utilizzare formule e funzioni personalizzate, in aggiunta alle funzioni e agli operatori forniti dalla grammatica delle espressioni di Integration Services. È ad esempio possibile convalidare i numeri delle carte di credito che usano la formula LUHN.

  • Convalidare i dati delle colonne e ignorare i record che contengono dati non validi. Uno script può ad esempio stabilire se l'importo delle spese postali è ragionevole e ignorare i record che includono importi troppo alti o troppo bassi.

Il componente script consente di includere in modo facile e veloce funzioni personalizzate in un flusso di dati. Se tuttavia si prevede di riutilizzare il codice di script in più pacchetti, è preferibile creare un componente personalizzato anziché utilizzare il componente script. Per ulteriori informazioni, vedere Sviluppo di un componente del flusso di dati personalizzato.

Nota

Se il componente script contiene uno script che tenta di leggere il valore di una colonna NULL, quando si esegue il pacchetto si verifica un errore. È consigliabile che lo script utilizzi il metodo IsNull per determinare se la colonna è NULL prima di tentare di leggere il valore della colonna.

Il componente script può essere utilizzato come origine, trasformazione o destinazione. Questo componente supporta un input e più output. A seconda di come viene utilizzato, il componente supporta un input o più output oppure entrambi. Lo script viene richiamato da ogni riga nell'input o nell'output.

  • Se utilizzato come origine, il componente script supporta più output.

  • Se utilizzato come trasformazione, il componente script supporta un input e più output.

  • Se utilizzato come destinazione, il componente script supporta un input.

Il componente script non supporta output degli errori.

Una volta stabilito che il componente Script è la scelta più appropriata per il pacchetto, è necessario configurare gli input e gli output, sviluppare lo script utilizzato dal componente e configurare il componente stesso.

Informazioni sulle modalità del componente script

In Progettazione SSIS sono disponibili due modalità per il componente script: progettazione metadati e progettazione codice. In modalità progettazione metadati è possibile aggiungere e modificare gli input e gli output del componente script, ma non scrivere codice. Dopo avere configurato tutti gli input e gli output è possibile passare alla modalità progettazione codice per creare lo script. Il componente script genera automaticamente il codice di base dai metadati degli input e degli output. Se si modificano i metadati dopo la generazione del codice di base, non sarà più possibile compilare il codice perché il codice di base aggiornato potrebbe essere incompatibile con quello inserito dall'utente.

Scrittura dello script utilizzato dal componente

Il componente script utilizza Microsoft Visual Studio Tools for Applications (VSTA) come ambiente di scrittura degli script. Si accede a VSTA dall'Editor trasformazione Script. Per ulteriori informazioni, vedere Editor trasformazione Script (pagina Script).

Il componente script fornisce un progetto VSTA che include una classe generata automaticamente, ScriptMain, che rappresenta i metadati del componente. Se ad esempio il componente script viene utilizzato come trasformazione con tre output, la classe ScriptMain includerà un metodo per ogni output. La classe ScriptMain costituisce il punto di ingresso dello script.

In VSTA sono disponibili tutte le caratteristiche standard dell'ambiente Visual Studio, come l'editor di Visual Studio con codifica a colori, la tecnologia IntelliSense e il Visualizzatore oggetti. Lo script utilizzato dal componente script è archiviato nella definizione del pacchetto. Durante la progettazione del pacchetto, il codice di script viene scritto temporaneamente in un file di progetto.

VSTA supporta i linguaggi di programmazione Microsoft Visual Basic 2008 e Microsoft Visual C# 2008.

Per informazioni sulla programmazione del componente script, vedere Estensione del flusso di dati con il componente script. Per ulteriori informazioni sulla configurazione del componente script come origine, trasformazione o destinazione, vedere Sviluppo di tipi specifici di componenti script. Per ulteriori esempi, come una destinazione ODBC che dimostri l'utilizzo del componente script, vedere Ulteriori esempi di componente script.

Nota

A differenza delle versioni precedenti in cui era possibile indicare se gli script fossero precompilati o meno, in SQL Server 2008 Integration Services (SSIS) tutti gli script sono precompilati. Se uno script è precompilato, il motore del linguaggio non verrà caricato in fase di esecuzione e il pacchetto verrà eseguito molto più rapidamente. I file binari precompilati occupano tuttavia una notevole quantità di spazio su disco.

Configurazione del componente script

Per configurare il componente script, procedere nel modo seguente:

  • Selezionare le colonne di input a cui fare riferimento.

    Nota

    È possibile configurare un solo input quando si utilizza Progettazione SSIS.

  • Specificare lo script che deve essere eseguito dal componente.

  • Specificare il linguaggio di scripting.

  • Specificare le variabili in sola lettura e in lettura e scrittura in elenchi delimitati da virgole.

  • Aggiungere altri output e le colonne di output a cui lo script assegna valori.

È possibile impostare le proprietà tramite Progettazione SSIS o a livello di programmazione.

Configurazione del componente script in Progettazione

Per ulteriori informazioni sulle proprietà che è possibile impostare nella finestra di dialogo Editor trasformazione Script, fare clic su uno degli argomenti seguenti:

Per ulteriori informazioni sull'impostazione di queste proprietà in Progettazione SSIS, fare clic sull'argomento seguente:

Configurazione del componente script a livello di programmazione

Per ulteriori informazioni sulle proprietà che è possibile impostare nella finestra Proprietà o a livello di programmazione, fare clic su uno degli argomenti seguenti:

Per ulteriori informazioni sulle procedure per l'impostazione delle proprietà, fare clic su uno degli argomenti seguenti:

Icona di Integration Services (piccola) Rimanere aggiornati con Integration Services

Per informazioni sui download, gli articoli, gli esempi e i video Microsoft più recenti, nonché sulle soluzioni selezionate dalla community, visitare la pagina Integration Services su MSDN o Technet:

Per ricevere notifica automatica su questi aggiornamenti, sottoscrivere i feed RSS disponibili nella pagina.