Condividi tramite


Attività Script

Data aggiornamento: 17 luglio 2006

L'attività Script fornisce il codice necessario per eseguire le funzioni non disponibili nelle trasformazioni e nelle attività predefinite di SQL Server 2005 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, oppure una sola volta per oggetto enumerato, anziché una volta per ogni riga di dati. 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 ulteriori informazioni, vedere Componente script.

Il codice creato dall'attività Script è costituito da istruzioni Microsoft Visual Basic .NET personalizzate che vengono compilate ed eseguite durante la fase di esecuzione del pacchetto.

È 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.

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

  • Specificare lo script personalizzato che deve essere eseguito dall'attività.
  • Specificare il nome della funzione che costituisce il punto di ingresso nello script.
  • Indicare se lo script è precompilato.
  • È facoltativamente possibile specificare gli elenchi delle variabili in sola lettura e in lettura e scrittura da utilizzare nello script.

L'attività Script utilizza Visual Studio for Applications (VSA) come motore per la scrittura e l'esecuzione degli script. Per eseguire uno script, VSA deve essere pertanto installato nei computer in cui viene eseguito il pacchetto.

Per ulteriori informazioni sulla scrittura di codice per l'attività Script, vedere Extending the Package with the Script Task.

Per gli script utilizzati da più di un pacchetto è preferibile creare un'attività personalizzata, anziché utilizzare l'attività Script. Per ulteriori informazioni, vedere Developing a Custom Task.

Ambiente Visual Studio for Applications

L'attività Script consente di accedere all'ambiente 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.

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.

L'attività Script offre numerosi vantaggi rispetto all'attività Script ActiveX:

  • Un ambiente di sviluppo integrato. VSA offre un IDE uguale a quello disponibile in altri strumenti di sviluppo Microsoft.
  • Un debugger integrato. VSA consente di eseguire il debug degli script utilizzando lo stesso debugger disponibile in altri strumenti di sviluppo Microsoft. I punti di interruzione degli script si integrano completamente con quelli delle attività e dei contenitori di Integration Services.
  • Utilizzo di un linguaggio basato su CLR (Common Language Runtime).
  • Integrazione con Progettazione SSIS.

L'attività Script sostituisce l'attività Script ActiveX che dovrà essere utilizzata solo quando necessario per garantire la compatibilità con le versioni precedenti. Questa funzionalità verrà rimossa a partire dalla prossima versione di Microsoft SQL Server. Non utilizzare questa funzionalità in un nuovo progetto di sviluppo e modificare appena possibile le applicazioni in cui questa funzionalità viene utilizzata.

Ottimizzazione

Gli script VSA devono essere compilati prima dell'esecuzione del pacchetto. L'attività Script offre la possibilità di precompilare gli script come codice binario al momento del salvataggio del pacchetto. Se lo script è precompilato, il motore del linguaggio non verrà caricato in fase di esecuzione e il pacchetto verrà eseguito molto più rapidamente. I file binari compilati occupano tuttavia una notevole quantità di spazio su disco. Se non si utilizza l'opzione di precompilazione, lo script verrà compilato in fase di esecuzione. Questo rallenta l'esecuzione del pacchetto ma consente di risparmiare spazio su disco. Se l'archiviazione di pacchetti di grandi dimensioni non costituisce un problema, è consigliabile precompilare gli script VSA. Inoltre, negli ambienti a 64 bit è possibile eseguire solo script precompilati.

Per decidere se precompilare o meno uno script è necessario tenere presente anche il fatto che gli script compilati non possono essere sottoposti a debug. Per impostazione predefinita l'attività Script è configurata per la precompilazione automatica degli script e la proprietà PreCompile dell'attività è 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.

Messaggi di registrazione personalizzati disponibili nell'attività Script

Nella tabella seguente è indicata la voce di log personalizzata disponibile per l'attività Script. Per ulteriori informazioni, vedere Implementazione della registrazione nei pacchetti e Messaggi personalizzati per la registrazione.

Voce di log Descrizione

ScriptTaskLogEntry

Restituisce i risultati dell'implementazione della registrazione nell'ambito dello script. Viene scritta una voce di log per ogni chiamata al metodo Log dell'oggetto Dts. Tale voce viene scritta al momento dell'esecuzione del codice. Per ulteriori informazioni, vedere Logging in the Script Task.

Configurazione dell'attività Script

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

Per ulteriori informazioni sulle proprietà che è possibile impostare in Progettazione SSIS, fare clic su uno degli argomenti seguenti:

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

Configurazione dell'attività Script a livello di programmazione

Per ulteriori informazioni sull'impostazione di queste proprietà a livello di programmazione, fare clic sull'argomento seguente:

Vedere anche

Concetti

Attività di Integration Services
Creazione del flusso di controllo di un pacchetto
Considerazioni su Integration Services in computer a 64 bit

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche

Versione Cronologia

17 luglio 2006

Contenuto modificato:
  • Aggiunta di una tabella di voci di log personalizzate.

5 dicembre 2005

Contenuto modificato:
  • Aggiunta dei suggerimenti relativi all'utilizzo dell'attività Script al posto del componente script.