Lektion 5.2: Aktivieren und Konfigurieren von Paketkonfigurationen

Artikel
05/23/2023

Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory

In dieser Aufgabe konvertieren Sie das Projekt in das Paketbereitstellungsmodell und aktivieren Paketkonfigurationen mithilfe des Paketkonfigurations-Assistenten. Sie verwenden diesen Assistenten zum Generieren einer XML-Konfigurationsdatei, die Konfigurationseinstellungen für die Directory-Eigenschaft des Foreach-Schleifencontainers enthält. Der Wert der Directory-Eigenschaft wird durch eine neue Variable auf Paketebene bereitgestellt, die Sie zur Laufzeit aktualisieren können. Zudem füllen Sie einen neuen Beispieldatenordner, den Sie zum Testen verwenden.

Erstellen Sie eine Variable auf Paketebene, die der Directory-Eigenschaft zugeordnet ist.

Wählen Sie den Hintergrund der Registerkarte Ablaufsteuerung im SSIS-Designer aus. Durch diese Auswahl wird der Bereich für die Variable, die Sie erstellen, auf das Paket festgelegt.
Wählen Sie im Menü SSIS den Befehl Variablenaus.
Wählen Sie im Fenster Variablen das Symbol Variable hinzufügen aus.
Geben Sie im Feld Name den Namen varFolderName ein.

Wichtig

Bei Variablennamen wird nach Groß-/Kleinschreibung unterschieden.
Überprüfen Sie, ob im Feld Bereich der Name des Pakets Lesson 5 (Lektion 5) angezeigt wird.
Legen Sie den Wert des Felds Datentyp der varFolderName -Variable auf Stringfest.
Kehren Sie zur Registerkarte Ablaufsteuerung zurück, und doppelklicken Sie auf den Foreach File in Folder -Container.
Klicken Sie auf der Seite Sammlung des Foreach-Schleifen-Editors auf Ausdrücke und anschließend auf die Schaltfläche mit den Auslassungspunkten (...).
Wählen Sie im Eigenschaftsausdrucks-Editor in die Liste Eigenschaft die Option Verzeichnis aus.
Klicken Sie im Feld Ausdruck auf die Schaltfläche mit den Auslassungspunkten (...).
Erweitern Sie im Ausdrucks-Generator den Ordner Variablen und Parameter, und ziehen Sie die Variable User::varFolderName in das Feld Ausdruck.
Klicken Sie auf OK, um den Ausdrucks-Generator zu beenden.
Klicken Sie auf OK, um den Eigenschaftsausdrucks-Editor zu beenden.
Klicken Sie auf OK, um den Foreach-Schleifen-Editor zu beenden.

Paketkonfigurationen aktivieren

Wählen Sie im Menü „Projekt“ die Option In Paketbereitstellungsmodell konvertieren aus.
Klicken Sie in der Warnmeldung auf OK, nachdem die Konvertierung abgeschlossen ist, und klicken Sie im Dialogfeld In Paketbereitstellungsmodell konvertieren auf OK.
Wählen Sie den Hintergrund der Registerkarte Ablaufsteuerung im SSIS-Designer aus.
Wählen Sie im Menü SSIS die Option Paketkonfigurationen aus.
Klicken Sie im Dialogfeld Paketkonfigurationsplaner auf Paketkonfigurationen aktivieren und anschließend auf Hinzufügen.
Klicken Sie auf der Willkommensseite des Paketkonfigurations-Assistenten auf Weiter.
Überprüfen Sie auf der Seite Konfigurationstyp auswählen , ob Konfigurationstyp auf XML-Konfigurationsdateifestgelegt ist.
Klicken Sie auf der Seite Konfigurationstyp auswählen auf Durchsuchen.
Das Dialogfeld Speicherort der Konfigurationsdatei auswählen mit dem Projektordner wird geöffnet.
Geben Sie im Dialogfeld Speicherort der Konfigurationsdatei auswählen als DateinamenSSISTutorialein, und klicken Sie auf Speichern.
Klicken Sie auf der Seite Konfigurationstyp auswählen auf Weiter.
Erweitern Sie Variablen auf der Seite Eigenschaften für den Exportvorgang auswählen im Bereich Objekte, erweitern Sie varFolderName und Eigenschaften, und wählen Sie anschließend Wertaus.
Klicken Sie auf der Seite Eigenschaften für den Exportvorgang auswählen auf Weiter.
Geben Sie auf der Seite Assistenten abschließen einen Konfigurationsnamen für die Konfiguration ein, beispielsweise SSIS Tutorial Directory configuration. Der Konfigurationsname wird im Dialogfeld Paketkonfigurationsplaner angezeigt.
Wählen Sie Fertig stellen aus.
Klicken Sie auf Schließen.
Vom Assistenten wird eine Konfigurationsdatei mit dem Namen SSISTutorial.dtsConfig erstellt, die die Konfigurationseinstellungen für den Wert Value der Variablen enthält, durch die wiederum die Directory-Eigenschaft des Enumerators festgelegt wird.

Hinweis

Eine Konfigurationsdatei enthält typischerweise komplexe Informationen zu den Paketeigenschaften. In diesem Tutorial sollte die einzige Konfigurationsinformation allerdings Folgende sein:
```
<Configuration 
    ConfiguredType="Property"  
    Path="\Package.Variables[User::varFolderName].Properties[Value]" 
    ValueType="String">  
  <ConfiguredValue></ConfiguredValue>  
</Configuration>
```

Erstellen und Füllen eines neuen Beispieldatenordners

Erstellen Sie im Windows-Explorer im Stammverzeichnis Ihres Laufwerks (beispielsweise C:) einen Ordner mit dem Namen Neue Beispieldaten.
Suchen Sie die Beispieldateien auf dem Computer, und kopieren Sie drei der Dateien aus dem Ordner.
Fügen Sie die kopierten Dateien in den Ordner Neue Beispieldaten ein.

Weiter zur nächsten Aufgabe

Schritt 3: Ändern des Directory-Eigenschaftskonfigurationswerts

Freigeben über