Freigeben über

Festlegen der Eigenschaften von benutzerdefinierten Variablen

  • Artikel

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 festgelegt. Um einen Ausdruck zum Festlegen des Werts zu verwenden, müssen Sie zunächst EvaluateAsExpression auf Truefestlegen 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 beispielsweise Value 0 enthält und die ValueType-Eigenschaft Int32 enthält und Sie expression auf GETDATE() festlegen, enthält Value das aktuelle Datum und die aktuelle Uhrzeit, und ValueType ist auf DateTimefestgelegt.

  • 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 EvaluateAsExpression-Eigenschaft im Eigenschaftenfenster wird automatisch auf Truefestgelegt.

  • 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 sowohl im Fenster Variablen als auch im Eigenschaftenfenster der Variablen einen Ausdruck zuweisen und EvaluateAsExpression auf Truefestgelegt ist, können Sie den Variablendatentyp 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

  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 dann die Werte in den NameSpalten , Datentyp, Value, NamespaceRaise Change Event, Description 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.

Weitere Informationen

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