Festlegen der Eigenschaften von benutzerdefinierten Variablen
Sie können eine der folgenden Funktionen verwenden, um die Eigenschaften einer benutzerdefinierten Variable in Integration Services festzulegen:
Fenster Variablen.
Eigenschaftenfenster. Im Eigenschaftenfenster werden Eigenschaften zum Konfigurieren von Variablen aufgelistet, die im Fenster Variablen nicht verfügbar sind: Description, EvaluateAsExpression, Expression, ReadOnly, ValueType und IncludeInDebugDump.
.gif "Hinweis") Hinweis |
|---|
Integration Services stellt außerdem einen Satz von Systemvariablen bereit, deren Eigenschaften, mit Ausnahme der RaiseChangedEvent-Eigenschaft, nicht aktualisiert werden können. |
Festlegen von Ausdrücken für Variablen
Wenn Sie das Eigenschaftenfenster verwenden, um Ausdrücke für eine benutzerdefinierte Variable festzulegen:
Der Wert dieser Variablen kann durch Value oder die Expression-Eigenschaft festgelegt werden. Standardmäßig ist die EvaluateAsExpression-Eigenschaft auf False festgelegt, und der Wert dieser Variablen wird durch die Value-Eigenschaft festgelegt. Um einen Ausdruck zum Festlegen des Werts zu verwenden, müssen Sie zuerst den EvaluateAsExpression auf True festlegen, und dann einen Ausdruck in der Expression-Eigenschaft bereitstellen. Die Value-Eigenschaft wird automatisch auf das Evaluierungsergebnis des Ausdrucks festgelegt.
Die ValueType-Eigenschaft enthält den Datentyp des Werts in der Value-Eigenschaft. Wenn Value automatisch durch einen Ausdruck festgelegt wird, dann wird ValueType automatisch auf einen Datentyp aktualisiert, der mit dem Evaluierungsergebnis des Ausdrucks kompatibel ist. Wenn Value beispielsweise 0 enthält und die ValueType-Eigenschaft Int32 enthält, und Sie dann Expression festlegen, um GETDATE() zu erhalten, enthält Value das aktuelle Datum und die aktuelle Zeit. ValueType wird dann auf DateTime festgelegt.
Das Eigenschaftenfenster für die Variable stellt den Zugriff auf das Dialogfeld Ausdrucks-Generator bereit. Sie können dieses Tool zum Erstellen, Überprüfen und Auswerten von Ausdrücken verwenden. Weitere Informationen finden Sie unter Ausdrucks-Generator und Integration Services-Ausdrücke (SSIS).
Wenn Sie das Fenster Variablen verwenden, um Ausdrücke für eine benutzerdefinierte Variable festzulegen:
Wenn Sie den Variablenwert mit einem Ausdruck festlegen möchten, stellen Sie zunächst sicher, dass der Variablendatentyp mit dem Auswertungsergebnis des Ausdrucks kompatibel ist. Stellen Sie dann einen Ausdruck in der Spalte Ausdruck im Fenster Variablen bereit. Die EvaluateAsExpression-Eigenschaft im Eigenschaftenfenster wird automatisch auf True festgelegt.
Wenn Sie einer Variablen einen Ausdruck zuweisen, wird ein spezieller Symbolmarker neben der Variablen angezeigt. Dieser spezielle Symbolmarker wird auch neben Verbindungs-Managern und Tasks angezeigt, für die Ausdrücke festgelegt wurden.
Das Fenster Variablen für die Variable stellt den Zugriff auf das Dialogfeld Ausdrucks-Generator bereit. Sie können dieses Tool zum Erstellen, Überprüfen und Auswerten von Ausdrücken verwenden. Weitere Informationen finden Sie unter Ausdrucks-Generator und Integration Services-Ausdrücke (SSIS).
Wenn Sie der Variablen im Fenster Variablen oder im Eigenschaftenfenster einen Ausdruck zuweisen und EvaluateAsExpression auf True festgelegt ist, können Sie den Datentyp der Variablen nicht ändern.
Festlegen des Namespaces und der Namenseigenschaften
Die Werte der Eigenschaften Name und Namespace müssen mit einem Buchstaben beginnen, wie in Unicode-Standard 2.0 definiert ist, oder mit einem Unterstrich (_). Bei nachfolgenden Zeichen kann es sich um Buchstaben oder Zahlen gemäß Unicode-Standard 2.0 oder um einem Unterstrich (_) handeln.
Verwenden des Variablenfensters zum Festlegen von Eigenschaften
So legen Sie die Eigenschaften einer Variablen mithilfe des Variablenfensters fest
Öffnen Sie in SQL Server-Datentools (SSDT) das Integration Services-Projekt mit dem gewünschten Paket.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Paket, um es zu öffnen.
Klicken Sie im Menü SSIS auf Variablen.
Sie können das Fenster Variablen auch anzeigen, indem Sie im Dialogfeld Optionen auf der Seite Tastatur den Befehl View.Variables einer beliebigen Tastenkombination zuordnen.
Klicken Sie optional im Fenster Variablen auf Rasteroptionen, und wählen Sie die Spalten aus, die im Fenster Variablen angezeigt werden sollen. Wählen Sie dann die Filter aus, die auf die Liste der Variablen angewendet werden sollen.
Wählen Sie die gewünschte Variable aus der Liste aus, und aktualisieren Sie dann die Werte in den Spalten Name, Datentyp, Wert, Namespace, Änderungsereignis auslösen, Beschriftung und Ausdruck.
Wählen Sie die Variable in der Liste aus, und klicken Sie dann auf Variable verschieben, um den Bereich zu ändern.
Klicken Sie im Menü Datei auf Ausgewählte Elemente speichern, um das aktualisierte Paket zu speichern.
Verwenden des Eigenschaftenfensters zum Festlegen von Eigenschaften
So legen Sie die Eigenschaften einer Variablen mithilfe des Eigenschaftenfensters fest
Öffnen Sie in SQL Server-Datentools (SSDT) das Integration Services-Projekt mit dem gewünschten Paket.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Paket, um es zu öffnen.
Klicken Sie im Menü Ansicht auf Eigenschaftenfenster.
Klicken Sie in SSIS-Designer auf die Registerkarte Paket-Explorer, und erweitern Sie den Paketknoten.
Um Variablen mit Paketbereich zu ändern, erweitern Sie den Variablenknoten. Erweitern Sie anderenfalls den Ereignishandlerknoten oder den Knoten für Ausführbare Dateien, bis Sie den Variablenknoten finden, der die zu ändernde Variable enthält.
Klicken Sie auf die Variable, deren Eigenschaften Sie ändern möchten.
Aktualisieren Sie im Fenster Eigenschaften die Variableneigenschaften des Lese/Schreibzugriffs. Einige Eigenschaften sind für benutzerdefinierte Variablen auf Nur Lesen festgelegt.
Weitere Informationen zu den Eigenschaften finden Sie unter Integration Services-Variablen (SSIS).
Klicken Sie im Menü Datei auf Ausgewählte Elemente speichern, um das aktualisierte Paket zu speichern.
Siehe auch
Aufgaben
Verwenden von Variablen in Paketen
Hinzufügen, Löschen, Ändern des Bereichs von benutzerdefinierten Variablen in einem Paket