Componente script

Si applica a:SQL Server SSIS Integration Runtime in Azure Data Factory

Il componente Script ospita lo script e consente a un pacchetto di includere ed eseguire codice 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.

  • Accedi alle regole di 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 altre 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 usi 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 di errore.

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 usa Microsoft Visual Studio Tools for Applications (VSTA) come ambiente di scrittura degli script. È possibile accedere a VSTA dall'Editor di trasformazione 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.

VSTA include tutte le funzionalità 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 e Microsoft Visual C#.

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

Nota

A differenza delle versioni precedenti in cui era possibile indicare se gli script erano precompilati o meno, in SQL Server 2008 Integration Services (SSIS) e versioni successive 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 usa 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 aggiungere colonne di output in cui lo script assegna valori.

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

Configurazione del componente Script nel Designer

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

Configurazione del componente script a livello di codice

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

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

Seleziona il tipo di componente script

Utilizzare la finestra di dialogo Seleziona tipo componente script per specificare la creazione di una trasformazione Script preconfigurata da utilizzare come origine, trasformazione o destinazione.

Per altre informazioni sul componente Script, vedere Configurazione del componente script nell'editor corrispondente. Per informazioni sulla programmazione del componente Script, vedere Estensione del flusso di dati con il componente script.

Opzioni

La selezione dell'opzione Origine, Destinazioneo Trasformazione influisce sulla configurazione della trasformazione Script e sulle pagine dell'editor trasformazione Script visualizzate.

Editor di trasformazione script (pagina Gestione connessioni)

Utilizzare la pagina Gestori connessioni dell'Editor di trasformazione script per specificare tutte le connessioni che verranno utilizzate dallo script.

Per altre informazioni sul componente Script, vedere Configurazione del componente script nell'editor corrispondente. Per informazioni sulla programmazione del componente Script, vedere Estensione del flusso di dati con il componente script.

Opzioni

Gestori delle connessioni
Consente di visualizzare l'elenco delle connessioni disponibili per l'utilizzo da parte dello script.

Nome
Consente di digitare un nome descrittivo univoco per la connessione.

Gestione connessioni
Selezionare una gestione connessione nell'elenco delle gestioni connessioni disponibili oppure selezionare <Nuova connessione>> per aprire la finestra di dialogo Aggiungi gestione connessione SSIS.

Descrizione
Consente di digitare una descrizione per la connessione.

Aggiunta
Aggiungi un'altra connessione all'elenco Gestori connessioni.

Rimuovi
Consente di rimuovere la connessione selezionata dall'elenco Gestioni connessioni .

Editor di trasformazione script (pagina delle colonne di input)

Usare la pagina Colonne di ingresso della finestra di dialogo Editor trasformazione script per impostare le proprietà delle colonne di ingresso.

Nota

La pagina Colonne di input non viene visualizzata per i componenti di origine, che hanno output ma non input.

Per altre informazioni sul componente Script, vedere Configurazione del componente script nell'editor corrispondente. Per informazioni sulla programmazione del componente Script, vedere Estensione del flusso di dati con il componente script.

Opzioni

Nome dell'input
Seleziona dall'elenco degli input disponibili.

Colonne di input disponibili
Usare le caselle di controllo per specificare le colonne che verranno utilizzate dalla trasformazione dello script.

Colonna di input
Consente di selezionare una colonna di input nell'elenco delle colonne di input disponibili per ogni riga. Le selezioni vengono riflesse nelle selezioni della casella di controllo nella tabella Colonne di input disponibili .

Alias di output
Consente di digitare un alias per ogni colonna di output. Per impostazione predefinita viene suggerito il nome della colonna di input. È comunque possibile scegliere qualsiasi nome descrittivo univoco.

Tipo di utilizzo
Consente di specificare se la trasformazione Script deve considerare ogni colonna come ReadOnly o ReadWrite.

Editor di trasformazione script (pagina Input e output)

Utilizzare la pagina Input e output della finestra di dialogo Editor della trasformazione script per aggiungere, rimuovere e configurare input e output per la trasformazione script.

Nota

I componenti di origine dispongono di output e di nessun input, mentre i componenti di destinazione dispongono di input e di nessun output. Le trasformazioni dispongono sia di input che di output.

Per altre informazioni sul componente Script, vedere Configurazione del componente script nell'editor corrispondente. Per informazioni sulla programmazione del componente Script, vedere Estensione del flusso di dati con il componente script.

Opzioni

Input e output
Selezionare un input o un output a sinistra per visualizzare le proprietà corrispondenti nella tabella a destra. Le proprietà modificabili variano in base alla selezione effettuata. Molte delle proprietà visualizzate sono di sola lettura. Per ulteriori informazioni sulle singole proprietà, vedere gli argomenti seguenti.

Proprietà comuni

Proprietà personalizzate delle trasformazioni

Aggiungi output
Aggiungi un ulteriore output all'elenco.

Aggiungi colonna
Selezionare una cartella in cui posizionare la nuova colonna di output e quindi aggiungere la colonna facendo clic su Aggiungi colonna.

Rimuovi output
Selezionare un output e quindi rimuoverlo facendo clic su Rimuovi output.

Rimuovi colonna
Selezionare una colonna e quindi rimuoverla facendo clic su Rimuovi colonna.

Editor di trasformazione Script (pagina Script)

Utilizzare la scheda Script della finestra di dialogo Editor di trasformazione script per specificare uno script e le relative proprietà.

Per altre informazioni sul componente Script, vedere Configurazione del componente script nell'editor corrispondente. Per informazioni sulla programmazione del componente Script, vedere Estensione del flusso di dati con il componente script.

Opzioni

Proprietà
Consente di visualizzare e modificare le proprietà della trasformazione Script. Molte delle proprietà visualizzate sono di sola lettura. È possibile modificare le proprietà seguenti:

Valore Descrizione
Descrizione Descriva la trasformazione dello script in termini di finalità.
LocaleID Specificare le impostazioni locali per fornire informazioni specifiche dell'area geografica per l'ordinamento e per la conversione di data e ora.
Nome Consente di digitare un nome descrittivo per il componente.
ValidateExternalMetadata Consente di specificare se la trasformazione Script convalida i metadati delle colonne in fase di progettazione utilizzando origini dei dati esterne. Il valore false consente di ritardare la convalida fino al momento dell'esecuzione.
ReadOnlyVariables Digitare un elenco di variabili separate da virgole a cui la trasformazione Script può accedere in sola lettura.

Nota: i nomi delle variabili fanno distinzione tra maiuscole e minuscole.
ReadWriteVariables Consente di digitare un elenco delimitato da virgole delle variabili per l'accesso di lettura/scrittura da parte della trasformazione Script.

Nota: per i nomi delle variabili viene fatta distinzione tra maiuscole e minuscole.
ScriptLanguage Selezionare il linguaggio di scripting che deve essere utilizzato dal componente Script.

Per impostare il linguaggio di scripting predefinito per componenti Script e attività Script, usare l'opzione Linguaggio di scripting nella pagina Generale della finestra di dialogo Opzioni .
UserComponentTypeName Specifica la classe ScriptComponentHost e l'assembly Microsoft.SqlServer.TxScript che supportano l'infrastruttura SQL Server.

Modifica script
Usare Microsoft Visual Studio Tools for Applications (VSTA) per creare o modificare uno script.

Contenuti correlati

  • Last updated on