Verwenden der Werte von Variablen und Parametern in einem untergeordneten Paket

In diesem Verfahren wird das Erstellen einer Paketkonfiguration beschrieben, die den Konfigurationstyp der übergeordneten Variablen verwendet. Durch diesen Konfigurationstyp kann ein untergeordnetes Paket, das von einem übergeordneten Paket ausgeführt wird, auf eine Variable im übergeordneten Element zugreifen.

Hinweis

Sie können auch Werte an ein untergeordnetes Paket übergeben, indem Sie den Task Paket ausführen konfigurieren, um untergeordneten Paketparametern Variablen oder Parameter für übergeordnete Pakete bzw. Projektparameter zuzuordnen. Weitere Informationen finden Sie unter Execute Package Task.

Es ist nicht erforderlich, die Variable im übergeordneten Paket zu erstellen, bevor Sie die Paketkonfiguration im untergeordneten Paket erstellen. Sie können dem übergeordneten Paket jederzeit die Variable hinzufügen. Allerdings müssen Sie in der Paketkonfiguration den genauen Namen der übergeordneten Variablen verwenden. Bevor Sie jedoch eine übergeordnete Variablenkonfiguration erstellen können, muss im untergeordneten Paket bereits eine Variable vorhanden sein, die von der Konfiguration aktualisiert werden kann. Weitere Informationen zum Hinzufügen und Konfigurieren von Variablen finden Sie unter Hinzufügen, Löschen, Ändern des Bereichs von benutzerdefinierten Variablen in einem Paket.

Der Gültigkeitsbereich der Variablen im übergeordneten Paket, das in einer übergeordneten Variablenkonfiguration verwendet wird, kann auf den Task Paket ausführen, auf den Container, in dem der Task enthalten ist, oder auf das Paket festgelegt werden. Wenn in einem Paket mehrere gleichnamige Variablen vorhanden sind, wird die Variable verwendet, die im Gültigkeitsbereich des Tasks Paket ausführen am nächsten liegt. Der Gültigkeitsbereich, der am nächsten am Task Paket ausführen liegt, ist der Task selbst.

So fügen Sie einem übergeordneten Paket eine Variable hinzu

1. Öffnen Sie in SQL Server Data Tools (SSDT) das Integration Services-Projekt mit dem Paket, dem Sie eine Variable für die Weiterleitung an ein untergeordnetes Paket hinzufügen möchten.

2. Doppelklicken Sie im Projektmappen-Explorer auf das Paket, um es zu öffnen.

3. Gehen Sie im SSIS -Designer zum Definieren des Gültigkeitsbereichs der Variablen wie folgt vor:

   • Um den Gültigkeitsbereich des Pakets festzulegen, klicken Sie an eine beliebige Stelle auf der Entwurfsoberfläche der Registerkarte Ablaufsteuerung .

   • Wenn Sie den Bereich auf einen übergeordneten Container der Aufgabe "Execute Package" festlegen möchten, klicken Sie auf den Container.

   • Um den Bereich auf die Aufgabe "Paket ausführen" festzulegen, klicken Sie auf die Aufgabe.

4. Fügen Sie eine Variable hinzu, und konfigurieren Sie diese.

   Hinweis

   Wählen Sie einen Datentyp aus, der mit den in der Variablen gespeicherten Daten kompatibel ist.

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

So fügen Sie einem untergeordneten Paket eine Variable hinzu

1. Öffnen Sie in SQL Server Data Tools (SSDT) das Integration Services-Projekt mit dem Paket, dem Sie eine Variablenkonfiguration für ein übergeordnetes Paket hinzufügen möchten.

2. Doppelklicken Sie im Projektmappen-Explorer auf das Paket, um es zu öffnen.

3. Klicken Sie im SSIS-Designer auf eine beliebige Stelle auf der Entwurfsoberfläche der Registerkarte "Steuerungsfluss", um den Geltungsbereich auf das Paket festzulegen.

4. Fügen Sie eine Variable hinzu, und konfigurieren Sie diese.

   Hinweis

   Wählen Sie einen Datentyp aus, der mit den in der Variablen gespeicherten Daten kompatibel ist.

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

Um eine übergeordnete Paketkonfiguration zu einem Kindpaket hinzuzufügen

1. Wenn es noch nicht geöffnet ist, öffnen Sie das untergeordnete Paket in SQL Server Data Tools (SSDT).

2. Klicken Sie auf der Entwurfsoberfläche der Registerkarte "Steuerungsfluss " auf eine beliebige Stelle.

3. Klicken Sie im Menü SSIS auf Paketkonfigurationen.

4. Wählen Sie im Dialogfeld " Paketkonfigurationsorganisation " die Option "Paketkonfiguration aktivieren" aus, und klicken Sie dann auf "Hinzufügen".

5. Klicken Sie auf der Willkommensseite des Assistenten für die Paketkonfiguration auf "Weiter".

6. Wählen Sie auf der Seite "Konfigurationstyp auswählen" in der Liste " Konfigurationstyp " die Option "Übergeordnete Paketvariable " aus, und führen Sie eine der folgenden Aktionen aus:

   • Wählen Sie "Konfigurationseinstellungen direkt angeben" aus, und geben Sie dann im Feld " Übergeordnete Variable " den Namen der Variablen im übergeordneten Paket an, die in der Konfiguration verwendet werden soll.

     Von Bedeutung

     Bei Variablennamen wird nach Groß-/Kleinschreibung unterschieden.

   • Wählen Sie den Konfigurationsspeicherort, der in einer Umgebungsvariable gespeichert ist, und wählen Sie dann in der Umgebungsvariablenliste die Umgebungsvariable aus, die den Namen der Variablen enthält.

7. Klicke auf Weiter.

8. Erweitern Sie auf der Seite "Zieleigenschaft auswählen" den Knoten " Variable " und erweitern Sie den Eigenschaftenknoten der zu konfigurierenden Variable, und klicken Sie dann auf die Eigenschaft, die von der Konfiguration festgelegt werden soll.

9. Klicke auf Weiter.

10. Ändern Sie optional auf der Seite "Assistent abschließen" den Standardnamen der Konfiguration, und überprüfen Sie die Konfigurationsinformationen.

11. Klicken Sie auf "Fertig stellen ", um den Assistenten abzuschließen und zum Dialogfeld " Paketkonfigurationsorganisation " zurückzukehren.

12. Im Dialogfeld " Paketkonfigurationsorganisation " listet das Dialogfeld "Konfiguration " die neue Konfiguration auf.

13. Klicken Sie auf Schließen.

Siehe auch

Paketkonfigurationen
Erstellen von Paketkonfigurationen
Integration Services-Variablen (SSIS)
Verwenden von Variablen in Paketen