Lektion 1-4: Hinzufügen von Paketkonfigurationen
Gilt für: SQL Server SSIS Integration Runtime in Azure Data Factory
In diesem Schritt fügen Sie jedem Paket eine Konfiguration hinzu. Konfigurationen aktualisieren die Werte von Paketeigenschaften und Paketobjekten zur Laufzeit.
Integration Services stellt eine Vielzahl von Konfigurationstypen bereit. Sie können Konfigurationen in Umgebungsvariablen, Registrierungseinträgen, benutzerdefinierten Variablen, SQL Server -Tabellen und XML-Dateien speichern. Integration Services unterstützt die Verwendung von indirekten Konfigurationen und bietet damit zusätzliche Flexibilität. Das bedeutet, dass Sie eine Umgebungsvariable verwenden, um den Speicherort der Konfiguration anzugeben, die wiederum die eigentlichen Werte angibt. Bei den Paketen im Deployment Tutorial-Projekt wird eine Kombination aus XML-Konfigurationsdateien und indirekten Konfigurationen verwendet. Eine XML-Konfigurationsdatei kann Konfigurationen für mehrere Eigenschaften enthalten, und gegebenenfalls können mehrere Pakete darauf verweisen. In diesem Lernprogramm verwenden Sie eine separate Konfigurationsdatei für jedes Paket.
Konfigurationsdateien enthalten oft vertrauliche Informationen wie Verbindungszeichenfolgen. Deshalb sollten Sie eine Zugriffssteuerungsliste (Access Control List, ACL) verwenden, um den Zugriff auf den Speicherort oder Ordner zu beschränken, in dem Sie die Dateien speichern, und nur den Benutzern oder Konten Zugriff erteilen, die zum Ausführen der Pakete berechtigt sind. Weitere Informationen finden Sie unter Zugriff auf Dateien, die von Paketen verwendet werden.
Die Pakete (DataTransfer und LoadXMLData), die Sie dem Deployment Tutorial-Projekt in der vorherigen Aufgabe hinzugefügt haben, benötigen Konfigurationen, damit sie nach der Bereitstellung auf dem Zielserver erfolgreich ausgeführt werden können. Zum Implementieren von Konfigurationen erstellen Sie zuerst die indirekten Konfigurationen für die XML-Konfigurationsdateien und dann die XML-Konfigurationsdateien.
Sie erstellen die beiden Konfigurationsdateien DataTransferConfig.dtsConfig und LoadXMLData.dtsConfig. Diese Dateien enthalten Name/Wert-Paare zur Aktualisierung der Eigenschaften von Paketen, die den vom Paket verwendeten Speicherort der Daten und Protokolldateien angeben. Später aktualisieren Sie im Rahmen des Bereitstellungsprozesses die Werte in den Konfigurationsdateien, um den neuen Speicherort der Dateien auf dem Zielcomputer zu berücksichtigen.
Integration Services erkennt, dass DataTransferConfig.dtsConfig und LoadXMLData.dtsConfig Abhängigkeiten der DataTransfer- und LoadXMLData-Pakete darstellen und fügt automatisch die Konfigurationsdateien ein, wenn Sie in der folgenden Lektion das Bereitstellungspaket erstellen.
So erstellen Sie eine indirekte Konfiguration für das DataTransfer-Paket
Überprüfen Sie das aktuelle Bereitstellungsmodell des Projekts, und legen Sie es bei Bedarf auf Paketbereitstellungsmodell fest. Klicken Sie im Menü Projektauf In Paketbereitstellungsmodell konvertieren.
Doppelklicken Sie im Projektmappen-Explorer auf DataTransfer.dtsx.
Klicken Sie im SSIS -Designer auf eine beliebige Stelle im Vordergrund der Entwurfsoberfläche der Ablaufsteuerung.
Klicken Sie im Menü SSIS auf Paketkonfigurationen.
Wählen Sie im Dialogfeld Paketkonfigurationsplanergegebenenfalls die Option Paketkonfigurationen aktivieren aus, und klicken Sie anschließend auf Hinzufügen.
Klicken Sie auf der Willkommensseite des Paketkonfigurations-Assistenten auf Weiter.
Wählen Sie auf der Seite Konfigurationstyp auswählen die Option XML-Konfigurationsdatei in der Liste Konfigurationstyp aus. Wählen Sie die Option Konfigurationsspeicherort ist in einer Umgebungsvariablen gespeichert aus, und geben Sie DataTransfer ein, oder wählen Sie die DataTransfer -Umgebungsvariable in der Liste aus.
Hinweis
Sie müssen möglicherweise Ihren Computer nach Hinzufügen der Variablen neu starten, um die Umgebungsvariable in der Liste verfügbar zu machen. Wenn Sie den Computer nicht neu starten möchten, können Sie den Namen der Umgebungsvariablen eingeben.
Klicken Sie auf Weiter.
Geben Sie auf der Seite „Assistenten abschließen“ im Feld KonfigurationsnameDataTransfer EV Configuration ein, prüfen Sie den Inhalt der Konfiguration im Bereich Vorschau , und klicken Sie anschließend auf Fertig stellen.
Schließen Sie das Dialogfeld Paketkonfigurationsplaner.
So erstellen Sie die XML-Konfiguration für das DataTransfer-Paket
Doppelklicken Sie im Projektmappen-Explorer auf DataTransfer.dtsx.
Klicken Sie im SSIS -Designer auf eine beliebige Stelle im Vordergrund der Entwurfsoberfläche der Ablaufsteuerung.
Klicken Sie im Menü SSIS auf Paketkonfigurationen.
Aktivieren Sie im Dialogfeld Paketkonfigurationsplaner das Kontrollkästchen Paketkonfigurationen aktivieren , und klicken Sie anschließend auf Hinzufügen.
Klicken Sie auf der Willkommensseite des Paketkonfigurations-Assistenten auf Weiter.
Wählen Sie auf der Seite Konfigurationstyp auswählen die Option XML-Konfigurationsdatei in der Liste Konfigurationstyp aus, und klicken Sie anschließend auf Durchsuchen.
Navigieren Sie im Dialogfeld Speicherort der Konfigurationsdatei auswählen zu „C:\DeploymentTutorial“, geben Sie im Feld DateinameDataTransferConfig ein, und klicken Sie anschließend auf Speichern.
Klicken Sie auf der Seite „Konfigurationstyp auswählen“ auf Weiter.
Erweitern Sie auf der Seite Eigenschaften für den Exportvorgang auswählen DataTransfer, Connection Managers, Deployment Tutorial Log und Properties, und aktivieren Sie anschließend das Kontrollkästchen Verbindungszeichenfolge .
Erweitern Sie innerhalb von Connection Managers die Option NewCustomers, und aktivieren Sie anschließend das Kontrollkästchen Verbindungszeichenfolge .
Klicken Sie auf Weiter.
Geben Sie auf der Seite „Assistenten abschließen“ im Feld KonfigurationsnameDataTransfer Configuration ein, überprüfen Sie den Inhalt der Konfiguration, und klicken Sie anschließend auf Fertig stellen.
Überprüfen Sie im Dialogfeld Paketkonfigurationsplaner , ob DataTransfer EV Configuration als Erstes und DataTransfer Configuration als Zweites aufgeführt wird, und klicken Sie anschließend auf Schließen.
So erstellen Sie eine indirekte Konfiguration für das LoadXMLData-Paket
Doppelklicken Sie im Projektmappen-Explorer auf LoadXMLData.dtsx.
Klicken Sie im SSIS -Designer auf eine beliebige Stelle im Vordergrund der Entwurfsoberfläche der Ablaufsteuerung.
Klicken Sie im Menü SSIS auf Paketkonfigurationen.
Klicken Sie im Dialogfeld Paketkonfigurationsplanerauf Hinzufügen.
Klicken Sie auf der Willkommensseite des Paketkonfigurations-Assistenten auf Weiter.
Wählen Sie auf der Seite Konfigurationstyp auswählen die Option XML-Konfigurationsdatei in der Liste Konfigurationstyp aus. Wählen Sie die Option Konfigurationsspeicherort ist in einer Umgebungsvariablen gespeichert aus, und geben Sie LoadXMLData ein, oder wählen Sie die LoadXMLData -Umgebungsvariable in der Liste aus.
Hinweis
Sie müssen möglicherweise Ihren Computer nach Hinzufügen der Variablen neu starten, um die Umgebungsvariable in der Liste verfügbar zu machen.
Klicken Sie auf Weiter.
Geben Sie auf der Seite „Assistenten abschließen“ im Feld KonfigurationsnameLoadXMLData EV Configuration ein, überprüfen Sie den Inhalt der Konfiguration, und klicken Sie anschließend auf Fertig stellen.
So erstellen Sie die XML-Konfiguration für das LoadXMLData-Paket
Doppelklicken Sie im Projektmappen-Explorer auf LoadXMLData.dtsx.
Klicken Sie im SSIS -Designer auf eine beliebige Stelle im Vordergrund der Entwurfsoberfläche der Ablaufsteuerung.
Klicken Sie im Menü SSIS auf Paketkonfigurationen.
Aktivieren Sie im Dialogfeld Paketkonfigurationsplaner das Kontrollkästchen Paketkonfigurationen aktivieren , und klicken Sie auf Hinzufügen.
Klicken Sie auf der Willkommensseite des Paketkonfigurations-Assistenten auf Weiter.
Wählen Sie auf der Seite Konfigurationstyp auswählen die Option XML-Konfigurationsdatei in der Liste Konfigurationstyp aus, und klicken Sie auf Durchsuchen.
Navigieren Sie im Dialogfeld Speicherort der Konfigurationsdatei auswählen zu „C:\DeploymentTutorial“, geben Sie im Feld DateinameLoadXMLDataConfig ein, und klicken Sie anschließend auf Speichern.
Klicken Sie auf der Seite „Konfigurationstyp auswählen“ auf Weiter.
Erweitern Sie auf der Seite „Eigenschaften für den Exportvorgang auswählen“ LoadXMLData, Executables, Load XML Data und Properties, und aktivieren Sie anschließend die Kontrollkästchen [XMLSource].[XMLData] und [XMLSource].[XMLSchemaDefinition] .
Klicken Sie auf Weiter.
Geben Sie auf der Seite „Assistenten abschließen“ im Feld KonfigurationsnameLoadXMLData Configuration ein, überprüfen Sie den Inhalt der Konfiguration, und klicken Sie anschließend auf Fertig stellen.
Überprüfen Sie im Dialogfeld Paketkonfigurationsplaner , ob „LoadXMLData EV Configuration“ als Erstes und „LoadXMLData Configuration“ als Zweites aufgeführt wird, und klicken Sie anschließend auf Schließen.
Nächste Aufgabe in der Lektion
Schritt 5: Testen der aktualisierten Pakete
Weitere Informationen
Paketkonfigurationen
Erstellen von Paketkonfigurationen
Zugriff auf Dateien, die von Paketen verwendet werden