Vorgehensweise: Festlegen der Eigenschaften einer Variablen

Sie können die folgenden Features verwenden, um die Eigenschaften einer benutzerdefinierten Variablen in Integration Services festzulegen:

  • Das Fenster Variablen.

  • Das Eigenschaftenfenster. Im Eigenschaftenfenster werden Eigenschaften zum Konfigurieren von Variablen aufgelistet, die im Fenster Variablen nicht verfügbar sind: Description, EvaluateAsExpression, Expression, ReadOnly und ValueType.

HinweisHinweis

Integration Services stellt außerdem einen Satz von Systemvariablen bereit, deren Eigenschaften nicht aktualisiert werden können.

Verwenden des Variablenfensters zum Festlegen von Eigenschaften

So legen Sie die Eigenschaften einer Variablen mithilfe des Variablenfensters fest

  1. Öffnen Sie in Business Intelligence Development Studio 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 im Fenster Variablen auf Alle Variablen anzeigen.

  5. Klicken Sie wahlweise auf Variablenspalten auswählen und wählen Sie im Dialogfeld Variablenspalten auswählen die gewünschten Spaltenoptionen oder löschen Sie diese.

  6. Wählen Sie die gewünschte Variable aus der Liste aus, und aktualisieren Sie dann die Werte in den Spalten Datentyp, Wert, Namespace und Änderungsereignis auslösen.

    HinweisHinweis

    Die Werte in der Spalte Wert müssen mit dem in der Spalte Datentyp angegebenem Datentyp kompatibel sein.

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

Verwenden des Eigenschaftenfensters zum Festlegen von Eigenschaften

Wenn Sie das Eigenschaftenfenster verwenden, um die Eigenschaften einer benutzerdefinierten 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 Referenzinformationen zu SQL Server Integration Services-Ausdrücken.

So legen Sie die Eigenschaften einer Variablen mithilfe des Eigenschaftenfensters fest

  1. Öffnen Sie in Business Intelligence Development Studio 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 des Lese/Schreibzugriffs. Einige Eigenschaften sind für benutzerdefinierte Variablen auf Nur Lesen festgelegt.

    In der folgenden Tabelle werden die Variablen aufgelistet, die möglicherweise aktualisiert wurden.

    Lese/Schreibeigenschaft

    Aktualisierungsaktion

    Description

    Ändern der Beschreibung.

    EvaluateAsExpression

    Auf True festlegen, um das Evaluierungsergebnis eines Ausdrucks in der Value-Eigenschaft zu verwenden.

    Expression

    Klicken Sie auf (…), um das Dialogfeld Ausdrucks-Generator zu öffnen, und erstellen Sie einen Ausdruck mithilfe des grafischen Tools, oder geben Sie einen Ausdruck ein.

    Name

    Bei benutzerdefinierten Variablen können Sie den Namen der Variablen ändern.

    Namespace

    Bei benutzerdefinierten Variablen können Sie den Namen der Variablen ändern.

    RaiseChangedEvent

    Festlegen auf True, um ein Ereignis auszulösen, wenn die Variable den Wert ändert.

    ReadOnly

    Legen Sie benutzerdefinierte Variablen auf True fest, um die Variable auf Lesen/Schreiben festzulegen.

    Value

    Bei benutzerdefinierten Variablen können Sie den Namen der Variablen angeben. Der Wert muss mit dem Werttyp in der ValueType-Eigenschaft kompatibel sein.

    ValueType

    Geben Sie für benutzerdefinierte Variablen den Datentyp des Variablenwerts an.

    Wichtiger HinweisWichtig

    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.

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