Systemvariablen

Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory

SQL Server Integration Services stellt eine Reihe von Systemvariablen bereit, mit denen Informationen zum ausgeführten Paket und dessen Objekten gespeichert werden können. Diese Variablen können in Ausdrücken und Eigenschaftsausdrücken verwendet werden, um Pakete, Container, Tasks und Ereignishandler anzupassen.

Alle Variablen, seien es Systemvariablen oder benutzerdefinierte Variablen, können in den Parameterbindungen verwendet werden, die der Task „SQL ausführen“ zum Zuordnen von Variablen zu Parametern verwendet.

Systemvariablen für Pakete

In der folgenden Tabelle werden die Systemvariablen beschrieben, die Integration Services für Pakete bereitstellt.

Systemvariable	Datentyp	BESCHREIBUNG
CancelEvent	Int32	Das Handle für ein Windows-Ereignisobjekt, das der Task signalisieren kann, um anzugeben, dass das Ausführen des Tasks beendet werden soll.
ContainerStartTime	Datetime	Die Startzeit für den Container.
CreationDate	Datetime	Das Datum, an dem das Paket erstellt wurde.
CreatorComputerName	String	Der Computer, auf dem das Paket erstellt wurde.
CreatorName	String	Der Name der Person, die das Paket erstellt hat.
ExecutionInstanceGUID	String	Der eindeutige Bezeichner der ausführenden Instanz eines Pakets.
FailedConfigurations	String	Die Namen von fehlerhaften Paketkonfigurationen.
IgnoreConfigurationsOnLoad	Boolean	Gibt an, ob die Paketkonfigurationen beim Laden des Pakets ignoriert werden.
InteractiveMode	Boolean	Gibt an, ob das Paket im interaktiven Modus ausgeführt wird. Wenn ein Paket im SSIS -Designer ausgeführt wird, ist diese Eigenschaft auf TRUEfestgelegt. Wenn ein Paket mit dem Eingabeaufforderungs-Hilfsprogramm DTExec ausgeführt wird, ist diese Eigenschaft auf FALSEfestgelegt.
LocaleId	Int32	Das Gebietsschema, das vom Paket verwendet wird.
MachineName	String	Der Name des Computers, auf dem das Paket ausgeführt wird.
OfflineMode	Boolean	Gibt an, ob sich das Paket im Offlinemodus befindet. Im Offlinemodus werden keine Verbindungen mit Datenquellen abgerufen.
PackageID	String	Der eindeutige Bezeichner des Pakets.
PackageName	String	Der Name des Pakets.
StartTime	Datetime	Der Zeitpunkt, zu dem das Paket gestartet wurde.
ServerExecutionID	Int64	Die Ausführungs-ID für das Paket, das auf dem Integration Services -Server ausgeführt wird. Der Standardwert ist 0 (null). Der Wert wird nur geändert, wenn das Paket von "ISServerExec" auf dem Server Integration Services ausgeführt wird. Wenn ein untergeordnetes Paket vorhanden ist, wird der Wert vom übergeordneten Paket an das untergeordnete Paket übergeben.
UserName	String	Das Konto des Benutzers, der das Paket gestartet hat. Der Benutzername wird durch den Domänennamen qualifiziert.
VersionBuild	Int32	Die Paketversion
VersionComment	String	Kommentare zur Paketversion
VersionGUID	String	Der eindeutige Bezeichner der Version.
VersionMajor	Int32	Die Hauptversion des Pakets.
VersionMinor	Int32	Die Nebenversion des Pakets.

Systemvariablen für Container

In der folgenden Tabelle werden die Systemvariablen beschrieben, die Integration Services für For-Schleifencontainer, Foreach-Schleifencontainer und Sequenzcontainer bereitstellt.

Systemvariable	Datentyp	BESCHREIBUNG	Container
LocaleId	Int32	Das Gebietsschema, das vom Container verwendet wird.	For-Schleifencontainer Foreach-Schleifencontainer Sequenzcontainer

Systemvariablen für Tasks

In der folgenden Tabelle werden die Systemvariablen beschrieben, die Integration Services für Tasks bereitstellt.

Systemvariable	Datentyp	BESCHREIBUNG
CreationName	String	Der Name der Aufgabe.
LocaleId	Int32	Das Gebietsschema, das vom Task verwendet wird.
TaskID	String	Der eindeutige Bezeichner einer Taskinstanz.
TaskName	String	Der Name der Taskinstanz.
TaskTransactionOption	Int32	Die Transaktionsoption, die vom Task verwendet wird.

Systemvariablen für Ereignishandler

In der folgenden Tabelle werden die Systemvariablen beschrieben, die Integration Services für Ereignishandler bereitstellt. Nicht alle Variablen sind für alle Ereignishandler verfügbar.

Systemvariable	Datentyp	BESCHREIBUNG	Ereignishandler
Abbrechen	Boolean	Gibt an, ob das Ausführen des Ereignishandlers bei einem Fehler, einer Warnung oder beim Abbruch einer Abfrage beendet wird.	OnError-Ereignishandler OnWarning-Ereignishandler OnQueryCancel-Ereignishandler
ErrorCode	Int32	Der Fehlerbezeichner.	OnError-Ereignishandler OnInformation-Ereignishandler OnWarning-Ereignishandler
ErrorDescription	String	Die Beschreibung des Fehlers.	OnError-Ereignishandler OnInformation-Ereignishandler OnWarning-Ereignishandler
ExecutionStatus	Boolean	Der aktuelle Ausführungsstatus.	OnExecStatusChanged-Ereignishandler
ExecutionValue	DBNull	Der Ausführungswert.	OnTaskFailed-Ereignishandler
LocaleId	Int32	Das Gebietsschema, das vom Ereignishandler verwendet wird.	Alle Ereignishandler
PercentComplete	Int32	Der Prozentsatz abgeschlossener Arbeit.	OnProgress-Ereignishandler
ProgressCountHigh	Int32	Der obere Bereich eines 64-Bit-Werts, der die Gesamtanzahl von Vorgängen angibt, die vom OnProgress-Ereignis verarbeitet wurden.	OnProgress-Ereignishandler
ProgressCountLow	Int32	Der untere Bereich eines 64-Bit-Werts, der die Gesamtanzahl von Vorgängen angibt, die vom OnProgress-Ereignis verarbeitet wurden.	OnProgress-Ereignishandler
ProgressDescription	String	Die Beschreibung des Status.	OnProgress-Ereignishandler
Propagate	Boolean	Gibt an, ob das Ereignis an einen Ereignishandler auf höherer Ebene weitergegeben wird. Hinweis: Der Wert der Propagate -Variablen wird während der Überprüfung des Pakets ignoriert. Wenn Sie Propagate in einem untergeordneten Paket auf FALSE festlegen, wird ein Ereignis dennoch an das übergeordnete Paket weitergegeben.	Alle Ereignishandler
SourceDescription	String	Die Beschreibung der ausführbaren Datei in dem Ereignishandler, der das Ereignis ausgelöst hat.	Alle Ereignishandler
SourceID	String	Der eindeutige Bezeichner der ausführbaren Datei in dem Ereignishandler, der das Ereignis ausgelöst hat.	Alle Ereignishandler
SourceName	String	Der Name der ausführbaren Datei in dem Ereignishandler, der das Ereignis ausgelöst hat.	Alle Ereignishandler
VariableDescription	String	Die Variablenbeschreibung.	OnVariableValueChanged-Ereignishandler
VariableID	String	Der eindeutige Bezeichner der Variablen.	OnVariableValueChanged-Ereignishandler

Systemvariablen in Parameterbindungen

Es ist häufig nützlich, beim Ausführen des Pakets die Werte von Systemvariablen in Tabellen zu speichern. Beispielsweise ein Paket, das eine Tabelle dynamisch erstellt und den GUID der Paketausführungsinstanz schreibt, mit der die Tabelle in einer Tabellenspalte erstellt wurde.

Wenn Sie Systemvariablen verwenden, um diese Parameter der SQL-Anweisung zuzuordnen, die von einem Task SQL ausführen verwendet wird, müssen Sie unbedingt sicherstellen, dass der Datentyp der einzelnen Parameterbindungen auf den jeweiligen Datentyp der Systemvariablen festgelegt ist. Andernfalls kann es sein, dass die Werte der Systemvariablen falsch übersetzt werden. Wenn beispielsweise die Systemvariable ExecutionInstanceGUID mit dem Zeichenfolgen-Datentyp und einer Zeichenfolge, mit der die GUID der ausführenden Instanz eines Pakets dargestellt wird, in einer Parameterbindung mit dem GUID-Datentyp verwendet wird, wird die GUID der Paketinstanz falsch übersetzt.

Diese Regel gilt auch für benutzerdefinierte Variablen. Während die Datentypen der Systemvariablen nicht geändert werden können, und Sie diese Variablen den Datentypen entsprechend anpassen müssen, sind benutzerdefinierte Variablen jedoch im Vergleich hierzu flexibler. Die in Parameterbindungen verwendeten benutzerdefinierten Variablen sind in der Regel mit den Datentypen definiert, die mit den zugeordneten Datentypen der Parameter kompatibel sind.

Related Tasks

Zuordnen von Abfrageparametern zu Variablen in einem Task SQL ausführen