Componente script
Data aggiornamento: 17 luglio 2006
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 utilizzando 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 Developing a Custom Data Flow Component.
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.
Per configurare il componente script, procedere nel modo seguente:
- Selezionare le colonne di input a cui fare riferimento.
- Specificare lo script che deve essere eseguito dal componente.
- Specificare se lo script è precompilato.
- 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.
La finestra di dialogo Editor trasformazione Script in Progettazione SSIS consente di configurare un solo input.
Per creare gli script, accedere all'ambiente Visual Studio for Applications (VSA) dalla finestra di dialogo Editor trasformazione Script. In VSA sono disponibili tutte le funzionalità standard dell'ambiente Visual Studio .NET, come l'editor di Visual Studio con codifica a colori, la tecnologia IntelliSense ed Esplora oggetti. Lo script utilizzato dal componente script è archiviato nella definizione del pacchetto. Non viene creato un file script separato.
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.
Script
Il componente script fornisce un progetto VSA 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.
L'ambiente di sviluppo di script Visual Studio for Applications supporta solo il linguaggio di scripting Microsoft Visual Basic .NET.
Per informazioni sulla programmazione del componente script, vedere Extending the Data Flow with the Script Component. Per ulteriori informazioni sulla configurazione del componente script come origine, trasformazione o destinazione, vedere Developing Specific Types of Script Components. Per ulteriori esempi, come una destinazione ODBC che dimostri l'utilizzo del componente script, vedere Additional Script Component Examples.
Script precompilato
È possibile configurare il componente script in modo da precompilare lo script. Se lo script viene precompilato, verrà avviato più rapidamente e potrà essere eseguito anche in un ambiente a 64 bit. I pacchetti contenenti script precompilati hanno tuttavia dimensioni superiori. Non è inoltre possibile eseguire il debug di uno script compilato. Quando si decide se precompilare uno script, considerare i fattori seguenti.
Per impostazione predefinita, il componente script è configurato per la precompilazione automatica del relativo script e la proprietà PreCompile del componente è impostata su True. La proprietà PreCompile viene in genere impostata su False durante lo sviluppo e il debug di un pacchetto e quindi reimpostata su True prima della distribuzione del pacchetto.
Configurazione del componente script
È possibile impostare le proprietà tramite Progettazione SSIS o a livello di programmazione.
Per ulteriori informazioni sulle proprietà che è possibile impostare nella finestra di dialogo Editor trasformazione Script, fare clic su uno degli argomenti seguenti:
- Editor trasformazione Script (pagina Colonne di input)
- Editor trasformazione Script (pagina Input e output)
- Editor trasformazione Script (pagina Script)
- Editor trasformazione Script (pagina Gestioni connessioni)
Per ulteriori informazioni sulle proprietà che è possibile impostare nella finestra Proprietà o a livello di programmazione, fare clic su uno degli argomenti seguenti:
- Common Properties
- Source Custom Properties
- Transformation Custom Properties
- Destination Custom Properties
Per ulteriori informazioni sulle procedure per l'impostazione delle proprietà, fare clic su uno degli argomenti seguenti:
- Procedura: Impostazione delle proprietà di un componente di un flusso di dati utilizzando l'editor del componente
- Procedura: Impostazione delle proprietà di un componente di un flusso di dati nella finestra Proprietà
Vedere anche
Concetti
Trasformazioni di Integration Services
Considerazioni su Integration Services in computer a 64 bit
Altre risorse
Extending the Data Flow with the Script Component
Guida in linea e informazioni
Cronologia modifiche
| Versione | Cronologia |
|---|---|
17 luglio 2006 |
|
5 dicembre 2005 |
|