Freigeben über

Verwenden der Werte von Variablen und Parametern in einem untergeordneten Paket

  • Artikel

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.

Dabei ist das Erstellen der Variablen im übergeordneten Paket vor dem Erstellen der Paketkonfiguration im untergeordneten Paket nicht erforderlich. 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 .

    • Klicken Sie auf den Container, um den Gültigkeitsbereich des übergeordneten Containers des Tasks "Paket ausführen" festzulegen.

    • Klicken Sie auf den Task, um den Bereich auf den Task "Paket ausführen" 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.

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 in der Entwurfsoberfläche der Registerkarte Ablaufsteuerung, um den Gültigkeitsbereich des Pakets 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.

So fügen Sie einem untergeordneten Paket eine übergeordnete Paketkonfiguration hinzu

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

  2. Klicken Sie an eine beliebige Stelle auf der Entwurfsoberfläche der Registerkarte Ablaufsteuerung .

  3. Klicken Sie im Menü SSIS auf Paketkonfigurationen.

  4. Wählen Sie im Dialogfeld Paketkonfigurationsplaner die Option Paketkonfigurationen aktivierenaus, und klicken Sie dann auf Hinzufügen.

  5. Klicken Sie auf der Willkommensseite des Paketkonfigurations-Assistenten 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 die Option Konfigurationseinstellungen direkt angebenaus, und stellen Sie dann im Feld Übergeordnete Variable den Variablennamen des in der Konfiguration zu verwendenden übergeordneten Pakets bereit.

      Wichtig

      Bei Variablennamen wird nach Groß-/Kleinschreibung unterschieden.

    • Wählen Sie Konfigurationsspeicherort ist in einer Umgebungsvariablen gespeichert aus. Wählen Sie dann in der Liste Umgebungsvariabledie Umgebungsvariable aus, die den Namen der Variablen enthält.

  7. Klicken Sie auf Weiter.

  8. Erweitern Sie auf der Seite Zieleigenschaft auswählen den Knoten Variable , erweitern Sie den Knoten Eigenschaften der zu konfigurierenden Variablen, und klicken Sie dann auf die von der Konfiguration festzulegende Eigenschaft.

  9. Klicken Sie auf Weiter.

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

  11. Klicken Sie auf Fertig stellen , um den Assistenten zu beenden und zum Dialogfeld Paketkonfigurationsplaner zurückzukehren.

  12. Die neue Konfiguration wird im Dialogfeld Paketkonfigurationsplaner im Feld Konfiguration aufgelistet.

  13. Klicken Sie auf Schließen.

Weitere Informationen

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