Share via


Erstellen von Parametern

Sie verwenden SQL Server-Datentools (SSDT), um Projektparameter und Paketparameter zu erstellen. Die folgenden Prozeduren stellen schrittweise Anweisungen zum Erstellen von Paket-/Projektparametern bereit.

HinweisHinweis

Wenn Sie ein Projekt, das Sie mit einer früheren Version von Integration Services erstellt haben, in das Projektbereitstellungsmodell konvertieren, können Sie mit dem Assistent für die Konvertierung von Integration Services-Projekten Parameter auf Grundlage von Konfigurationen erstellen. Weitere Informationen finden Sie unter Bereitstellen von Projekten auf dem Integration Services-Server.

So erstellen Sie Paketparameter

  1. Öffnen Sie das Paket in SQL Server-Datentools, und klicken Sie dann auf die Registerkarte Parameter im SSIS-Designer.

    Paketparameter (Registerkarte)

  2. Klicken Sie auf die Schaltfläche Parameter hinzufügen auf der Symbolleiste.

    Symbolleistenschaltfläche hinzufügen

  3. Geben Sie Werte für die Eigenschaften Name, Datentyp, Wert, Vertraulich und Erforderlich in der Liste selbst oder im Fenster Eigenschaften ein. In der folgenden Tabelle werden diese Eigenschaften beschrieben.

    Eigenschaft

    Beschreibung

    Name

    Der Name des Parameters.

    Datentyp

    Der Datentyp des Parameters.

    Standardwert

    Der Standardwert für den zur Entwurfszeit zugewiesenen Parameter. Dieser wird auch als Entwurfsstandard bezeichnet.

    Vertraulich

    Sensible Parameterwerte werden im Katalog verschlüsselt und in Transact-SQL oder SQL Server Management Studio als NULL-Wert angezeigt.

    Erforderlich

    Dazu muss ein anderer als der Entwurfsstandardwert angegeben werden, bevor das Paket ausgeführt werden kann.

    Beschreibung

    Die Beschreibung des Parameters für bessere Verwaltbarkeit. Legen Sie im Visual Studio-Eigenschaftenfenster von SQL Server-Datentools (SSDT) die Parameterbeschreibung fest, wenn der Parameter im entsprechenden Parameterfenster ausgewählt wurde.

    HinweisHinweis

    Wenn Sie im Katalog ein Projekt bereitstellen, werden dem Projekt einige weitere Eigenschaften zugeordnet. Um alle Eigenschaften für alle Parameter im Katalog anzuzeigen, verwenden Sie die catalog.object_parameters (SSISDB-Datenbank)-Sicht.

  4. Speichern Sie das Projekt, um Änderungen an Parametern zu speichern. Parameterwerte werden in der Projektdatei gespeichert.

    VorsichtshinweisVorsicht

    Nehmen Sie Bearbeitungen direkt in der Liste vor oder verwenden Sie das Fenster Eigenschaften, um die Werte von Parametereigenschaften zu ändern. Sie können mit der Symbolleistenschaltfläche Löschen (X) einen Parameter löschen. Über die letzte Symbolleistenschaltfläche können Sie einen Wert für einen Parameter angeben, der nur verwendet wird, wenn Sie das Paket in SQL Server-Datentools ausführen.

    HinweisHinweis

    Wenn Sie die Paketdatei erneut öffnen, ohne das Projekt in SQL Server-Datentools zu öffnen, ist die Registerkarte Parameter leer und deaktiviert.

So erstellen Sie das Projektparameter

  1. Öffnen Sie das Projekt in SQL Server-Datentools.

  2. Klicken Sie mit der rechten Maustaste auf Project.params im Projektmappen-Explorer, und klicken Sie auf Öffnen (Oder)Doppelklicken Sie zum Öffnen auf Project.params.

    Projektparameter (Fenster)

  3. Klicken Sie auf die Schaltfläche Parameter hinzufügen auf der Symbolleiste.

    Symbolleistenschaltfläche hinzufügen

  4. Geben Sie Werte für die Eigenschaften Name, Datentyp, Wert, Vertraulich und Erforderlich ein.

    Eigenschaft

    Beschreibung

    Name

    Der Name des Parameters.

    Datentyp

    Der Datentyp des Parameters.

    Standardwert

    Der Standardwert für den zur Entwurfszeit zugewiesenen Parameter. Dieser wird auch als Entwurfsstandard bezeichnet.

    Vertraulich

    Sensible Parameterwerte werden im Katalog verschlüsselt und in Transact-SQL oder SQL Server Management Studio als NULL-Wert angezeigt.

    Erforderlich

    Dazu muss ein anderer als der Entwurfsstandardwert angegeben werden, bevor das Paket ausgeführt werden kann.

    Beschreibung

    Die Beschreibung des Parameters für bessere Verwaltbarkeit. Legen Sie im Visual Studio-Eigenschaftenfenster von SQL Server-Datentools die Parameterbeschreibung fest, wenn der Parameter im entsprechenden Parameterfenster ausgewählt wurde.

  5. Speichern Sie das Projekt, um Änderungen an Parametern zu speichern. Parameterwerte werden in Konfigurationen in der Projektdatei gespeichert. Speichern Sie die Projektdatei, um alle Änderungen in den Parameterwerten in einem Commit an den Datenträger zu übergeben.

    VorsichtshinweisVorsicht

    Nehmen Sie Bearbeitungen direkt in der Liste vor oder verwenden Sie das Fenster Eigenschaften, um die Werte von Parametereigenschaften zu ändern. Sie können mit der Symbolleistenschaltfläche Löschen (X) einen Parameter löschen. Über die letzte Symbolleistenschaltfläche können Sie das Dialogfeld Parameterwerte verwalten öffnen, um einen Wert für einen Parameter anzugeben, der nur verwendet wird, wenn Sie das Paket in SQL Server-Datentools ausführen.

Siehe auch

Konzepte

Integration Services (SSIS)-Parameter