TechNet
Exportieren (0) Drucken
Alle erweitern

Paketkonfigurationen

 

Betrifft: SQL Server 2016

SQL Server Integration Services Stellt Paketkonfigurationen, die Sie verwenden können, um die Werte der Eigenschaften zur Laufzeit zu aktualisieren.

System_CAPS_ICON_note.jpg 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 Deployment of Projects and Packages.

Eine Konfiguration ist ein Eigenschaft/Wert-Paar, das zu einem fertigen Paket hinzugefügt werden kann. Normalerweise erstellen Sie ein Paket, legen bei der Paketentwicklung die Eigenschaften der Paketobjekte fest und fügen die Konfiguration dem Paket hinzu. Bei der Ausführung ruft das Paket die neuen Werte für die Eigenschaften aus der Konfiguration ab. Sie können mithilfe einer Konfiguration beispielsweise die Verbindungszeichenfolge eines Verbindungs-Managers ändern oder den Wert einer Variablen aktualisieren.

Paketkonfigurationen bieten die folgenden Vorteile:

  • Konfigurationen erleichtern das Verschieben von Paketen aus einer Entwicklungsumgebung in eine Produktionsumgebung. Mit einer Konfiguration können Sie z. B. den Pfad einer Quelldatei aktualisieren oder den Namen einer Datenbank oder eines Servers ändern.

  • Konfigurationen sind nützlich, wenn Sie Pakete für viele unterschiedliche Server bereitstellen. Eine Variable in der Konfiguration für jedes bereitgestellte Paket kann beispielsweise verschiedene Speicherplatzwerte enthalten, und wenn der verfügbare Speicherplatz nicht dem Wert entspricht, kann das Paket nicht ausgeführt werden.

  • Konfigurationen machen Pakete flexibler. So kann z. B. eine Konfiguration den Wert einer Variablen aktualisieren, die in einem Eigenschaftsausdruck verwendet wird.

Integration Services unterstützt verschiedene unterschiedliche Methoden zum Speichern von Paketkonfigurationen, z. B. XML-Dateien, Tabellen in einem SQL Server -Datenbank und umgebungs- und Paketvariablen.

Jede Konfiguration besteht aus einem Paar aus Eigenschaft und Wert. Die XML-Konfigurationsdatei und die SQL Server-Konfigurationstypen können mehrere Konfigurationen enthalten.

Die Konfigurationen werden einbezogen, wenn Sie ein Paketbereitstellungshilfsprogramm zum Installieren von Paketen erstellen. Wenn Sie die Pakete installieren, können die Konfigurationen im Rahmen eines Schritts bei der Paketinstallation aktualisiert werden.

Bei Verwendung der Dtexec Befehlszeilen-Hilfsprogramm (dtexec.exe) zum Ausführen eines bereitgestellten Pakets, das Dienstprogramm Paketkonfigurationen zweimal gilt. Das Hilfsprogramm wendet Konfigurationen sowohl vor als auch nach dem Anwenden der Optionen an, die Sie in der Befehlszeile angegeben haben.

Während das Hilfsprogramm das Paket lädt und ausführt, treten Ereignisse in der folgenden Reihenfolge auf:

  1. Die Dtexec Dienstprogramm lädt das Paket.

  2. Das Hilfsprogramm wendet die Konfigurationen, die zur Entwurfszeit im Paket angegeben wurden, in der Reihenfolge an, die im Paket festgelegt ist. (Die einzige Ausnahme ist hierbei die Variablenkonfiguration für übergeordnete Pakete. Das Hilfsprogramm wendet diese Konfigurationen nur einmal später im Prozess an.)

  3. Das Hilfsprogramm wendet dann alle Optionen an, die Sie in der Befehlszeile angegeben haben.

  4. Anschließend lädt das Hilfsprogramm die Konfigurationen neu, die zur Entwurfszeit im Paket angegeben wurden. Dabei wird die Reihenfolge verwendet, die im Paket festgelegt ist. (Die Ausnahme von dieser Regel ist wiederum die Variablenkonfiguration für übergeordnete Pakete.) Das Hilfsprogramm verwendet alle angegebenen Befehlszeilenoptionen, um die Konfigurationen neu zu laden. Es kann also sein, dass andere Werte von einem anderen Speicherort erneut geladen werden.

  5. Das Hilfsprogramm wendet die Variablenkonfiguration für übergeordnete Pakete an.

  6. Das Hilfsprogramm führt das Paket aus.

Die Art, wie die Dtexec Hilfsprogramm wendet Konfigurationen wirkt sich auf die folgenden Befehlszeilenoptionen:

  • Sie können die /Connection oder /Set Option zur Laufzeit, um Paketkonfigurationen von einem anderen Speicherort als den Speicherort zu laden, die Sie zur Entwurfszeit angegeben.

  • Sie können die /ConfigFile Option aus, um zusätzliche Konfigurationen zu laden, die Sie zur Entwurfszeit nicht angegeben haben.

Für diese Befehlszeilenoptionen gelten jedoch einige Einschränkungen:

  • Können keine der /Set oder /Connection Option, um einzelne Werte zu überschreiben, die auch von einer Konfiguration festgelegt werden.

  • Sie können keine der /ConfigFile Option aus, um die Konfigurationen zu laden, die Konfigurationen zu ersetzen, die Sie zur Entwurfszeit angegeben.

Weitere Informationen zu diesen Optionen und wie Unterschied des Verhaltens dieser Optionen SQL Server 2016 Integration Services (SSIS) und frühere Versionen finden Sie unter Verhaltensänderungen von Integration Services-Funktionen in SQL Server 2016.

Die folgende Tabelle beschreibt die verschiedenen Paketkonfigurationstypen.

TypBeschreibung
XML-KonfigurationsdateiEine XML-Datei enthält die Konfigurationen. Die XML-Datei kann mehrere Konfigurationen enthalten.
UmgebungsvariableEine Umgebungsvariable enthält die Konfiguration.
RegistrierungseintragEin Registrierungseintrag enthält die Konfiguration.
Variable für das übergeordnete PaketEine Variable im Paket enthält die Konfiguration. Dieser Konfigurationstyp wird normalerweise zum Aktualisieren von Eigenschaften in untergeordneten Paketen verwendet.
SQL Server tableEine Tabelle in einer SQL Server-Datenbank enthält die Konfiguration. Die Tabelle kann mehrere Konfigurationen enthalten.

XML-Konfigurationsdateien

Bei Auswahl der XML-Konfigurationsdatei Konfigurationstyp, eine neue Konfigurationsdatei erstellen, eine vorhandene Datei erneut verwenden und neue Konfigurationen hinzufügen oder eine vorhandene Datei überschreiben vorhandene Wiederverwendung Inhalt der Datei.

Eine XML-Konfigurationsdatei besteht aus zwei Abschnitten:

  • Einer Überschrift, die Informationen zur Konfigurationsdatei enthält. Dieses Element enthält Attribute wie z. B. der Erstellungszeitpunkt der Datei und den Namen der Person, von der die Datei erstellt wurde.

  • Konfigurationselemente können Informationen zu jeder Konfiguration enthalten. Dieses Element enthält Attribute wie z. B. den Eigenschaftspfad und den konfigurierten Wert einer Eigenschaft.

Das folgende XML-Codebeispiel veranschaulicht die Syntax von XML-Konfigurationsdateien. Dieses Beispiel zeigt eine Konfiguration für die Value-Eigenschaft einer ganzzahligen Variablen mit dem Namen MyVar.

<?xml version="1.0"?>  
<DTSConfiguration>  
   <DTSConfigurationHeading>  
      <DTSConfigurationFileInfo  
          GeneratedBy="DomainName\UserName"  
          GeneratedFromPackageName="Package"  
          GeneratedFromPackageID="{2AF06766-817A-4E28-9878-0DE37A150648}"  
          GeneratedDate="2/01/2005 5:58:09 PM"/>  
   </DTSConfigurationHeading>  
   <Configuration ConfiguredType="Property" Path="\Package.Variables[User::MyVar].Value" ValueType="Int32">  
      <ConfiguredValue>0</ConfiguredValue>  
   </Configuration>  
</DTSConfiguration>  
  

Registrierungseintrag

Wenn Sie zum Speichern einer Konfiguration einen Registrierungseintrag verwenden möchten, können Sie entweder einen vorhandenen Schlüssel verwenden oder einen neuen Schlüssel in HKEY_CURRENT_USER erstellen. Der Registrierungsschlüssel, mit denen Sie müssen einen Wert mit dem Namen Wert. Bei diesem Wert kann es sich um einen Wert vom Typ DWORD oder um eine Zeichenfolge handeln.

Bei Auswahl der Registrierungseintrag Konfigurationstyp, Sie den Namen des Registrierungsschlüssels im Eingabefeld eingeben. Das Format ist < Registrierungsschlüssel>. Wenn Sie einen Registrierungsschlüssel verwenden, die nicht der Stamm von HKEY_CURRENT_USER möchten, verwenden Sie das Format < Registry Key\registry Key\... > zum Identifizieren des Schlüssels. Geben Sie zum Beispiel für die Verwendung der Schlüssel befindet sich im SSISPackages MyPackage.

SQL Server

Bei Auswahl der SQL Server Konfigurationstyp, geben Sie die Verbindung mit der SQL Server Datenbank, die Konfigurationen gespeichert werden soll. Sie können die Konfigurationen in einer vorhandenen Tabelle speichern oder eine neue Tabelle in der angegebenen Datenbank erstellen.

Die folgende SQL-Anweisung zeigt die standardmäßige CREATE TABLE-Anweisung, die der Paketkonfigurations-Assistent bereitstellt.

CREATE TABLE [dbo].[SSIS Configurations]  
(  
ConfigurationFilter NVARCHAR(255) NOT NULL,  
ConfiguredValue NVARCHAR(255) NULL,  
PackagePath NVARCHAR(255) NOT NULL,  
ConfiguredValueType NVARCHAR(20) NOT NULL  
)  
  

Der Name, den Sie für die Konfiguration der in gespeicherte Wert ist die ConfigurationFilter Spalte.

Integration Services ermöglicht direkte und indirekte Konfigurationen. Wenn Sie Konfigurationen direkt angeben, erstellt Integration Services ein direkter Link zwischen dem Konfigurationselement und der Paketobjekteigenschaft. Direkte Konfigurationen sind die bessere Wahl, wenn sich der Speicherort der Quelle nicht ändert. Wenn Sie z. B. sicher sind, dass alle Bereitstellungen im Paket denselben Dateipfad verwenden, können Sie eine XML-Konfigurationsdatei angeben.

Indirekte Konfigurationen verwenden Umgebungsvariablen. Statt die Konfigurationseinstellung direkt anzugeben, zeigt die Konfiguration auf eine Umgebungsvariable, die ihrerseits den Konfigurationswert enthält. Das Verwenden indirekter Konfigurationen ist die bessere Wahl, wenn sich der Speicherort der Konfiguration für jede Bereitstellung eines Pakets ändern kann.

Erstellen von Paketkonfigurationen

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2016 Microsoft