Variabili di sistema
Data aggiornamento: 15 settembre 2007
SQL Server 2005 Integration Services (SSIS) include un set di variabili di sistema in cui vengono archiviate informazioni sui pacchetti in esecuzione e sui relativi oggetti. Tali variabili possono essere utilizzate nelle espressioni e nelle espressioni di proprietà per personalizzare pacchetti, contenitori, attività e gestori di eventi.
Tutte le variabili, di sistema e definite dall'utente, possono essere utilizzate nelle associazioni di parametro utilizzate dall'attività Esegui SQL per mappare variabili a parametri.
Variabili di sistema per i pacchetti
Nella tabella seguente vengono descritte le variabili di sistema disponibili in Integration Services per i pacchetti.
| Variabile di sistema | Tipo di dati | Descrizione |
|---|---|---|
CancelEvent |
Int32 |
L'handle in un oggetto di evento Windows che l'attività può segnalare per indicare che l'attività deve essere arrestata. |
CreationDate |
DateTime |
Data di creazione del pacchetto. |
CreatorComputerName |
String |
Computer in cui è stato creato il pacchetto. |
CreatorName |
String |
Nome dell'utente che ha creato il pacchetto. |
ExecutionInstanceGUID |
String |
Identificatore univoco dell'istanza di esecuzione di un pacchetto. |
InteractiveMode |
Boolean |
Indica se il pacchetto viene eseguito in modalità interattiva. Se un pacchetto viene eseguito in Progettazione SSIS, questa proprietà viene impostata su True. Se un pacchetto viene eseguito tramite l'utilità della riga di comando DTExec, la proprietà viene impostata su False. |
LocaleId |
Int32 |
Impostazioni internazionali utilizzate dal pacchetto. |
MachineName |
String |
Nome del computer in cui viene eseguito il pacchetto. |
OfflineMode |
Boolean |
Indica se il pacchetto è in modalità non in linea. La modalità non in linea non acquisisce connessioni a origini dei dati. |
PackageID |
String |
Identificatore univoco del pacchetto. |
PackageName |
String |
Nome del pacchetto. |
StartTime |
DateTime |
Data e ora di inizio dell'esecuzione del pacchetto. |
UserName |
String |
Nome dell'account dell'utente che ha avviato il pacchetto. Il nome utente è qualificato dal nome del dominio. |
VersionBuild |
Int32 |
Versione del pacchetto. |
VersionComment |
String |
Commenti sulla versione del pacchetto. |
VersionGUID |
String |
Identificatore univoco della versione. |
VersionMajor |
Int32 |
Versione principale del pacchetto. |
VersionMinor |
Int32 |
Versione secondaria del pacchetto. |
Variabili di sistema per i contenitori
Nella tabella seguente vengono descritte le variabili di sistema disponibili in Integration Services per i contenitori Ciclo For, Ciclo Foreach e Sequenza.
| Variabile di sistema | Tipo di dati | Descrizione | Contenitore |
|---|---|---|---|
LocaleId |
Int32 |
Impostazioni internazionali utilizzate dal contenitore. |
Contenitore Ciclo For Contenitore Ciclo Foreach Contenitore Sequenza |
Variabili di sistema per le attività
Nella tabella seguente vengono descritte le variabili di sistema disponibili in Integration Services per le attività.
| Variabile di sistema | Tipo di dati | Descrizione |
|---|---|---|
CreationName |
String |
Nome dell'attività. |
LocaleId |
Int32 |
Impostazioni internazionali utilizzate dall'attività. |
TaskID |
String |
Identificativo univoco di un'istanza dell'attività. |
TaskName |
String |
Nome dell'istanza dell'attività. |
TaskTransactionOption |
Int32 |
Opzioni di transazione utilizzate dall'attività. |
Variabili di sistema per i gestori di eventi
Nella tabella seguente vengono descritte le variabili di sistema disponibili in Integration Services per i gestori di eventi. Non tutte le variabili sono disponibili per tutti i gestori di eventi.
Variabile di sistema
Tipo di dati
Descrizione
Gestore di evento
Cancel
Boolean
Indica se l'esecuzione del gestore di evento viene interrotta in caso di errore, avviso o annullamento della query.
Gestore dell'evento OnError
Gestore dell'evento OnWarning
Gestore dell'evento OnQueryCancel
ErrorCode
Int32
Identificatore dell'errore.
Gestore dell'evento OnError
Gestore dell'evento OnInformation
Gestore dell'evento OnWarning
ErrorDescription
String
Descrizione dell'errore.
Gestore dell'evento OnError
Gestore dell'evento OnInformation
Gestore dell'evento OnWarning
ExecutionStatus
Boolean
Stato di esecuzione corrente.
Gestore dell'evento OnExecStatusChanged
ExecutionValue
DBNull
Valore di esecuzione.
Gestore dell'evento OnTaskFailed
LocaleId
Int32
Impostazioni internazionali utilizzate dal gestore di evento.
Tutti i gestori di eventi
PercentComplete
Int32
Percentuale di avanzamento dell'operazione.
Gestore dell'evento OnProgress
ProgressCountHigh
Int32
Parte più significativa di un valore a 64 bit che indica il numero totale delle operazioni elaborate dall'evento OnProgress.
Gestore dell'evento OnProgress
ProgressCountLow
Int32
Parte meno significativa di un valore a 64 bit che indica il numero totale delle operazioni elaborate dall'evento OnProgress.
Gestore dell'evento OnProgress
ProgressDescription
String
Descrizione dell'avanzamento.
Gestore dell'evento OnProgress
Propagate
Boolean
Indica se l'evento viene propagato a un gestore di evento di livello superiore.
.gif "ms141788.note(it-it,SQL.90).gif")
Nota:
Il valore della variabile Propagate viene ignorato durante la convalida del pacchetto. Se viene impostato Propagate in False in un pacchetto figlio, questo non impedisce la propagazione di un evento nel pacchetto padre. Per impedire al pacchetto padre di gestire l'evento, impostare la proprietà DisableEventHandlers dell'attività Esegui pacchetto su True.
Tutti i gestori di eventi
SourceDescription
String
Descrizione dell'eseguibile nel gestore di evento che ha generato l'evento.
Tutti i gestori di eventi
SourceID
String
Identificatore univoco dell'eseguibile nel gestore di evento che ha generato l'evento.
Tutti i gestori di eventi
SourceName
String
Nome dell'eseguibile nel gestore di evento che ha generato l'evento.
Tutti i gestori di eventi
VariableDescription
String
Descrizione della variabile.
Gestore dell'evento OnVariableValueChanged
VariableID
String
Identificatore univoco della variabile.
Gestore dell'evento OnVariableValueChanged
Utilizzo di variabili di sistema nelle associazioni di parametro
È spesso consigliabile salvare in tabelle i valori delle variabili di sistema dopo l'esecuzione di un pacchetto. Si consideri ad esempio un pacchetto che crea dinamicamente una tabella e scrive in una colonna della tabella il GUID dell'istanza di esecuzione del pacchetto che ha creato la tabella.
Se si utilizzano variabili di sistema per eseguire il mapping dei parametri inclusi nell'istruzione SQL utilizzata da un'attività Esegui SQL, è importante impostare il tipo di dati di ogni associazione di parametro sul tipo di dati della variabile di sistema. In caso contrario i valori delle variabili di sistema potrebbero essere convertiti in modo errato. Se ad esempio la variabile di sistema ExecutionInstanceGUID, che ha tipo di dati string e contiene una stringa che rappresenta il GUID dell'istanza in esecuzione di un pacchetto, viene utilizzata nell'associazione di un parametro con tipo di dati GUID, il GUID dell'istanza del pacchetto non verrà convertito correttamente.
Questa regola vale anche per le variabili definite dall'utente ma, mentre i tipi di dati delle variabili di sistema non possono essere modificati ed è necessario adattare l'utilizzo di tali variabili in base ai relativi tipi di dati, le variabili definite dall'utente sono molto più flessibili. Le variabili definite dall'utente utilizzate nelle associazioni di parametro vengono in genere definite con tipi di dati compatibili con quelli dei parametri a cui sono mappate.
Vedere anche
Concetti
Pacchetti Integration Services
Contenitori in Integration Services
Attività di Integration Services
Gestori di eventi in Integration Services
Variabili in Integration Services
Guida in linea e informazioni
Cronologia modifiche
| Versione | Cronologia |
|---|---|
15 settembre 2007 |
|
5 dicembre 2005 |
|