Attività Script

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

L'attività Script fornisce il codice necessario per eseguire le funzioni non disponibili nelle trasformazioni e nelle attività predefinite di SQL Server Integration Services. Tale attività consente inoltre di combinare più funzioni in un unico script, anziché utilizzare più attività e trasformazioni. L'attività Script può essere utilizzata per operazioni che devono essere eseguite una sola volta in un pacchetto o una sola volta per oggetto enumerato, anziché una volta per ogni riga di dati.

È possibile utilizzare l'attività Script per gli scopi seguenti:

  • Accedere ai dati tramite tecnologie non supportate dai tipi di connessioni predefiniti. Negli script è ad esempio possibile utilizzare ADSI (Active Directory Service Interfaces) per accedere ad Active Directory ed estrarre i nomi utente.

  • Creare contatori delle prestazioni specifici dei pacchetti. Uno script può ad esempio creare un contatore delle prestazioni che viene aggiornato durante l'esecuzione di un'attività complessa o con prestazioni insufficienti.

  • Determinare il numero delle righe contenute nei file specificati o stabilire se sono vuoti e quindi modificare il flusso di controllo di un pacchetto in base alle informazioni ottenute. Se ad esempio un file non contiene righe, il valore di una determinata variabile verrà impostato su 0 e un vincolo di precedenza che valuta tale valore impedirà all'attività File system di copiare il file.

Se è necessario utilizzare lo script per eseguire le stesse operazioni per ogni riga di dati in una set, è consigliabile utilizzare il componente script anziché l'attività Script. Se ad esempio si desidera stabilire se l'importo delle spese postali è ragionevole e ignorare le righe di dati che includono importi troppo alti o troppo bassi, è consigliabile utilizzare il componente script. Per altre informazioni, vedere Componente script.

Per gli script utilizzati da più di un pacchetto è preferibile creare un'attività personalizzata, anziché utilizzare l'attività Script. Per altre informazioni, vedere Sviluppo di un'attività personalizzata.

Una volta stabilito che l'attività Script è la scelta più appropriata per il pacchetto, è necessario sia sviluppare lo script utilizzato dall'attività sia configurare l'attività stessa.

Scrittura ed esecuzione di script utilizzati dall'attività

L'attività Script usa Microsoft Visual Studio Tools for Applications (VSTA) come ambiente in cui scrivere gli script e come motore in cui eseguirli.

VSTA include tutte le funzionalità standard dell'ambiente Visual Studio, come l'editor di Visual Studio con codifica a colori, la tecnologia IntelliSense ed Esplora oggetti. VSTA usa anche lo stesso debugger usato da altri strumenti di sviluppo di Microsoft. I punti di interruzione degli script si integrano completamente con quelli delle attività e dei contenitori di Integration Services. VSTA supporta i linguaggi di programmazione Microsoft Visual Basic e Microsoft Visual C#.

Per eseguire uno script, VSTA deve essere pertanto installato nel computer in cui viene eseguito il pacchetto. Durante l'esecuzione di un pacchetto l'attività carica il motore di scripting ed esegue lo script. È possibile accedere ad assembly .NET esterni dagli script aggiungendo i riferimenti a tali assembly nel progetto. Attualmente non sono supportati riferimenti ad assembly .NET Core e .NET Standard.

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 dell'attività Script

Per configurare l'attività Script, procedere nel modo seguente:

  • Specificare lo script personalizzato che deve essere eseguito dall'attività.

  • Nel progetto VSTA specificare il metodo chiamato dal runtime di Integration Services come punto di ingresso nel codice dell'attività Script.

  • Specificare il linguaggio di scripting.

  • È facoltativamente possibile specificare gli elenchi delle variabili in sola lettura e in lettura e scrittura da utilizzare nello script.

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

Configurazione dell'attività Script in Progettazione

La tabella seguente illustra l'evento ScriptTaskLogEntry che può essere registrato per l'attività Script. L'evento ScriptTaskLogEntry viene selezionato per essere registrato sulla scheda Dettagli della finestra di dialogo Configura log SSIS . Per altre informazioni, vedere Registrazione di Integration Services (SSIS).

Voce di log Descrizione
ScriptTaskLogEntry Restituisce i risultati dell'implementazione della registrazione nell'ambito dello script. L'attività scrive una voce di log per ogni chiamata al metodo Log dell'oggetto Dts . Tali voci vengono scritte dall'attività al momento dell'esecuzione del codice. Per altre informazioni, vedere Registrazione nell'attività Script.

Per altre informazioni sulle proprietà che è possibile impostare in Progettazione SSIS, vedere gli argomenti seguenti:

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

Configurazione dell'attività Script a livello di codice

Per ulteriori informazioni sull'impostazione di queste proprietà a livello di codice, vedere l'argomento seguente:

Editor attività Script (pagina Generale)

Utilizzare la pagina Generale della finestra di dialogo Editor attività Script per assegnare un nome e una descrizione all'attività Script.

Per ulteriori informazioni sull'attività Script, vedere Script Task e Configurazione dell'attività Script nell'editor attività Script. Per informazioni sulla programmazione dell'attività Script, vedere Extending the Package with the Script Task.

Opzioni

Nome
Consente di digitare un nome univoco per l'attività Script. Tale nome viene utilizzato come etichetta nell'icona dell'attività.

Nota

I nomi delle attività devono essere univoci all'interno di un pacchetto.

Descrizione
Consente di digitare una descrizione dell'attività Script.

Editor attività Script (pagina Script)

Utilizzare la pagina Script della finestra di dialogo Editor attività Script per impostare le proprietà dello script e specificare le variabili accessibili per lo script.

Nota

In SQL Server 2008 Integration Services (SSIS) e versioni successive tutti gli script vengono precompilati. Nelle versioni precedenti, si imposta una proprietà PrecompileScriptIntoBinaryCode per specificare che lo script è stato precompilato.

Per ulteriori informazioni sull'attività Script, vedere Script Task e Configurazione dell'attività Script nell'editor attività Script. Per informazioni sulla programmazione dell'attività Script, vedere Extending the Package with the Script Task.

Opzioni

ScriptLanguage
Selezionare il linguaggio di scripting per l'attività, Microsoft Visual Basic o Microsoft Visual C#.

Dopo avere creato uno script per l'attività, non è possibile modificare il valore della proprietà ScriptLanguage .

Per impostare il linguaggio di scripting predefinito per l'attività Script, utilizzare l'opzione Linguaggio di scripting nella pagina Generale della finestra di dialogo Opzioni . Per ulteriori informazioni, vedere General Page.

EntryPoint
Specificare il metodo chiamato dal runtime di Integration Services come punto di ingresso nel codice dell'attività Script. Il metodo specificato deve essere nella classe ScriptMain del progetto Microsoft Visual Studio Tools for Applications (VSTA). ScriptMain è la classe predefinita generata dai modelli di script.

Se si modifica il nome del metodo nel progetto VSTA, è necessario modificare il valore della proprietà EntryPoint .

ReadOnlyVariables
Digitare un elenco delimitato da virgole di variabili di sola lettura disponibili per lo script oppure fare clic sul pulsante con i puntini di sospensione (...) e selezionare le variabili nella finestra di dialogo Seleziona variabili.

Nota

Per i nomi delle variabili viene fatta distinzione tra maiuscole e minuscole.

ReadWriteVariables
Digitare un elenco delimitato da virgole di variabili di lettura/scrittura disponibili per lo script oppure fare clic sul pulsante con i puntini di sospensione (...) e selezionare le variabili nella finestra di dialogo Seleziona variabili.

Nota

Per i nomi delle variabili viene fatta distinzione tra maiuscole e minuscole.

Modifica script
Apre VSTA IDE, dove è possibile creare o modificare lo script.