Erstellen von Paketkonfigurationen

Im Dialogfeld Paketkonfigurationsplaner und im Paketkonfigurationsassistenten erstellen Sie Paketkonfigurationen. Um auf diese Tools zuzugreifen, klicken Sie in SQL Server-Datentools (SSDT) im Menü SSIS auf Paketkonfigurationen.

Hinweis
Sie können auch durch Klicken auf die Schaltfläche mit den Auslassungspunkten neben der Eigenschaft Konfiguration auf den Paketkonfigurationsplaner zugreifen. Die Eigenschaft Konfiguration wird im Eigenschaftenfenster für das Paket angezeigt.

Hinweis

Konfigurationen sind für das Paketbereitstellungsmodell verfügbar. Parameter werden für das Projektbereitstellungsmodell anstelle von Konfigurationen verwendet. Mithilfe des Projektbereitstellungsmodells können Sie Integration Services-Projekte auf dem Integration Services-Server bereitstellen. Weitere Informationen zu Bereitstellungsmodellen finden Sie unter Bereitstellung von Projekten und Paketen.

Im Dialogfeld Paketkonfigurationsplaner können Sie Pakete zum Verwenden von Konfigurationen aktivieren, Konfigurationen hinzufügen und löschen sowie die bevorzugte Reihenfolge festlegen, in der die Konfigurationen geladen werden sollten.

Hinweis

Wenn Paketkonfigurationen in der bevorzugten Reihenfolge geladen werden, werden die Konfigurationen in der Reihenfolge geladen, in der sie im Dialogfeld Paketkonfigurationsplaner angezeigt werden, wobei mit der Konfiguration am Anfang der Liste begonnen wird. Zur Laufzeit werden Paketkonfigurationen möglicherweise aber nicht in der bevorzugten Reihenfolge geladen. Beispielsweise werden übergeordnete Paketkonfigurationen nach Konfigurierungen anderer Typen geladen.

Hinweis
Wenn mehrere Konfigurationen dieselbe Objekteigenschaft festlegen, wird der zuletzt geladene Wert zur Laufzeit verwendet.

Im Dialogfeld Paketkonfigurationsplaner führen Sie den Paketkonfigurations-Assistenten aus, der Sie durch die Schritte zum Erstellen einer Konfiguration führt. Um den Paketkonfigurations-Assistenten auszuführen, fügen Sie im Dialogfeld Paketkonfigurationsplaner eine neue Konfiguration hinzu, oder bearbeiten Sie eine vorhandene Konfiguration. Auf den Seiten des Assistenten wählen Sie den Konfigurationstyp aus. Sie legen fest, ob Sie direkt auf die Konfiguration zugreifen oder Umgebungsvariablen verwenden möchten, und Sie wählen die in der Konfiguration zu speichernden Eigenschaften aus.

Im folgenden Beispiel werden die Zieleigenschaften einer Variablen und eines Pakets gezeigt, so wie sie auf der Seite Assistenten abschließen des Paketkonfigurations-Assistenten angezeigt werden:

\Package.Variables[User::TodaysDate].Properties[RaiseChangedEvent]

\Package.Properties[MaximumErrorCount]

\Package.Properties[LoggingMode]

\Package.Properties[LocaleID]

\Package\My SQL Task.Variables[User::varTableName].Properties[Value]

In diesem Beispiel werden diese Eigenschaften von der Konfiguration aktualisiert:

• Die RaiseChangedEvent-Eigenschaft der benutzerdefinierten Variablen TodaysDate.

• Die Eigenschaften MaximumErrorCount, LoggingMode und LocaleID des Pakets.

• Die Value-Eigenschaft der benutzerdefinierten Variablen varTableName im Bereich des Tasks My SQL Task.

"\Package" stellt den Stamm dar, und Punkte (.) trennen die Objekte, die den Pfad für die von der Konfiguration aktualisierten Eigenschaft definieren. Die Namen von Variablen und Eigenschaften werden in eckigen Klammern eingeschlossen. Der Begriff Package wird immer in der Konfiguration verwendet, unabhängig vom Paketnamen. Für alle anderen Objekte im Pfad werden jedoch die benutzerdefinierten Namen verwendet.

Nachdem der Assistent beendet ist, wird die neue Konfiguration der Konfigurationsliste im Dialogfeld Paketkonfigurationsplaner hinzugefügt.

Hinweis

Auf der letzten Seite des Paketkonfigurations-Assistenten, der Seite Assistenten abschließen, werden die Zieleigenschaften der Konfiguration aufgelistet. Wenn Sie beim Ausführen von Paketen mithilfe des Eingabeaufforderungs-Hilfsprogramms dtexec die Eigenschaften aktualisieren möchten, können Sie die Zeichenfolgen, die die Eigenschaftspfade darstellen, generieren. Führen Sie hierzu den Paketkonfigurations-Assistenten aus, kopieren Sie dann die Zeichenfolgen, und fügen Sie diese im Eingabeaufforderungsfenster für die Verwendung mit der festgelegten Option von dtexec ein.

In der folgenden Tabelle werden die Spalten der Konfigurationsliste im Dialogfeld Paketkonfigurationsplaner beschrieben.

So erstellen Sie eine Paketkonfiguration

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

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

3. Klicken Sie im SSIS-Designer auf die Registerkarte Ablaufsteuerung, Datenfluss, Ereignishandler oder Paket-Explorer.

4. Klicken Sie im Menü SSIS auf Paketkonfigurationen.

5. Wählen Sie im Dialogfeld Paketkonfigurationsplaner die Option Paketkonfigurationen aktivieren aus, und klicken Sie dann auf Hinzufügen.

6. Klicken Sie auf der Willkommensseite des Paketkonfigurationsassistenten auf Weiter.

7. Geben Sie auf der Seite "Konfigurationstyp auswählen" den Konfigurationstyp an, und legen Sie dann die für den Konfigurationstyp relevanten Eigenschaften fest. Weitere Informationen finden Sie unter Referenz zur Benutzeroberfläche des Paketkonfigurations-Assistenten.

8. Wählen Sie auf der Seite zum Auswählen der zu exportierenden Eigenschaften die Eigenschaften von Paketobjekten aus, die in der Konfiguration enthalten sein sollen. Wenn der Konfigurationstyp nur eine Eigenschaft unterstützt, lautet die Überschrift dieser Assistentenseite Zieleigenschaft auswählen. Weitere Informationen finden Sie unter Referenz zur Benutzeroberfläche des Paketkonfigurations-Assistenten.

   Hinweis
   Nur die Konfigurationstypen XML-Konfigurationsdatei und SQL Server unterstützen die Berücksichtigung von mehreren Eigenschaften in einer Konfiguration.

9. Geben Sie auf der Seite "Assistenten abschließen" den Namen der Konfiguration ein, und klicken Sie dann auf Fertig stellen.

10. Zeigen Sie die Konfiguration im Dialogfeld Paketkonfigurationsplaner an.

11. Klicken Sie auf Schließen.

Externe Ressourcen

• Technischer Artikel, Grundlegendes zu Integration Services-Paketkonfigurationen, auf msdn.microsoft.com

• Blogeintrag zu Codebasiertes Erstellen von Paketen – Paketkonfigurationen auf www.sqlis.com.

• Blogeintrag zu API-Beispiel – Programmgesteuertes Hinzufügen einer Konfigurationsdatei zu einem Paket auf blogs.msdn.com.

Siehe auch

Konzepte

Paketkonfigurationen

Paketbereitstellung (SSIS)

Programmgesteuertes Arbeiten mit Variablen