Freigeben über


Festlegen der Eigenschaften einer User-Defined Variablen

Sie können eine der folgenden Funktionen verwenden, um die Eigenschaften einer benutzerdefinierten Variable in Integration Servicesfestzulegen:

  • Fenster "Variablen".

  • Eigenschaftenfenster. Im Fenster Eigenschaften werden die Eigenschaften zum Konfigurieren von Variablen aufgelistet, die im Fenster Variablen nicht zur Verfügung stehen: Description, EvaluateAsExpression, Expression, ReadOnly, ValueType und IncludeInDebugDump.

Hinweis

Integration Services stellt außerdem eine Gruppe 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 Fenster Eigenschaften verwenden, um Ausdrücke für eine benutzerdefinierte Variable festzulegen:

  • Der Wert dieser Variablen kann durch die Value-Eigenschaft oder die Expression-Eigenschaft festgelegt werden. Standardmäßig ist die EvaluateAsExpression-Eigenschaft auf False festgelegt, und der Wert der Variablen wird durch die Value-Eigenschaft bestimmt. Um einen Ausdruck zum Festlegen des Werts zu verwenden, müssen Sie zuerst EvaluateAsExpression auf True und dann einen Ausdruck in der Expression-Eigenschaft angeben. Die Value-Eigenschaft wird automatisch auf das Auswertungsergebnis des Ausdrucks festgelegt.

  • Die ValueType-Eigenschaft enthält den Datentyp des Werts in der Value-Eigenschaft. Wenn Value durch einen Ausdruck festgelegt wird, dann wird ValueType automatisch auf einen Datentyp aktualisiert, der mit dem Auswertungsergebnis des Ausdrucks kompatibel ist. Wenn "Value" zum Beispiel die 0 enthält und die Eigenschaft "ValueType" Int32 ist, und Sie dann "Expression" auf GETDATE() setzen, enthält "Value" das aktuelle Datum und die aktuelle Uhrzeit, und "ValueType" wird auf DateTime gesetzt.

  • 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:

  • Um einen Ausdruck zum Festlegen des Variablenwerts zu verwenden, vergewissern Sie sich zunächst, dass der Datentyp der Variablen mit dem Auswertungsergebnis des Ausdrucks kompatibel ist, und geben Sie dann einen Ausdruck in der Expression Spalte des Variablenfensters an. Die Eigenschaft EvaluateAsExpression im Eigenschaftenfenster wird automatisch auf True gesetzt.

  • 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).

Im Fenster "Variablen " und "Eigenschaften " können Sie den Variablendatentyp nicht ändern, wenn Sie der Variablen einen Ausdruck zuweisen und EvaluateAsExpression auf Truediese festgelegt sind.

Festlegen der Namespace- und Namenseigenschaften

Die Werte der Eigenschaften Name und Namespace müssen mit einem alphabetischen Buchstaben beginnen, wie vom Unicode-Standard 2.0 definiert, 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 Fensters "Variablen" fest

  1. Öffnen Sie in SQL Server Data Tools (SSDT) das Integration Services-Projekt mit dem gewünschten Paket.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Paket, um es zu öffnen.

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

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

  5. Wählen Sie die Variable in der Liste aus, und aktualisieren Sie die Werte in den Spalten Name, Datentyp, Value, Namespace, Änderungsereignis auslösen, Beschreibung und Expression.

  6. Wählen Sie die Variable in der Liste aus, und klicken Sie dann auf Variable verschieben , um den Bereich zu ändern.

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

  1. Öffnen Sie in SQL Server Data Tools (SSDT) das Integration Services-Projekt mit dem gewünschten Paket.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Paket, um es zu öffnen.

  3. Klicken Sie im Menü Ansicht auf Eigenschaftenfenster.

  4. Klicken Sie in SSIS -Designer auf die Registerkarte Paket-Explorer , und erweitern Sie den Paketknoten.

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

  6. Klicken Sie auf die Variable, deren Eigenschaften Sie ändern möchten.

  7. Aktualisieren Sie im Fenster Eigenschaften die Variableneigenschaften für den Lese-/Schreibzugriff. Einige Eigenschaften sind für benutzerdefinierte Variablen auf Nur Lesen festgelegt.

    Weitere Informationen zu den Eigenschaften finden Sie unter Integration Services-Variablen(SSIS).

  8. Klicken Sie im Menü Datei auf Ausgewählte Elemente speichern, um das aktualisierte Paket zu speichern.

Siehe auch

Integration Services-Variablen (SSIS)
Verwenden von Variablen in Paketen
Hinzufügen, Löschen, Ändern des Bereichs der User-Defined-Variable in einem Paket