Festlegen von Paketeigenschaften

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

Wenn Sie ein Paket in SQL Server Data Tools (SSDT) mithilfe der grafischen Benutzeroberfläche von Integration Services erstellen, legen Sie die Eigenschaften des Paketobjekts im Eigenschaftenfenster fest.

Das Fenster Eigenschaften stellt eine kategorisierte und alphabetische Liste der Eigenschaften bereit. Klicken Sie auf das Nach Kategorien-Symbol, um das Fenster Eigenschaften nach der Kategorie anzuordnen.

Bei der Anordnung nach der Kategorie werden die Eigenschaften im Fenster Eigenschaften in den folgenden Kategorien gruppiert:

Informationen zu zusätzlichen Paketeigenschaften, die Sie im Fenster Eigenschaften nicht festlegen können, finden Sie unter Package.

So legen Sie Paketeigenschaften im Eigenschaftenfenster fest.

Eigenschaften nach Kategorie

In den folgenden Tabellen sind die Paketeigenschaften nach Kategorie aufgelistet.

Prüfpunkte

Mit den Eigenschaften in dieser Kategorie können Sie das Paket von dem Punkt an, an dem der Fehler in der Paketablaufsteuerung auftrat, neu starten, anstatt das Paket vom Beginn der Ablaufsteuerung erneut auszuführen. Weitere Informationen finden Sie unter Neustarten von Paketen mit Prüfpunkten.

Eigenschaft BESCHREIBUNG
CheckpointFileName Der Name der Datei, die die Prüfpunktinformationen aufzeichnet, mit der ein Paket neu gestartet werden kann. Wenn das Paket erfolgreich ausgeführt wurde, wird diese Datei gelöscht.
CheckpointUsage Gibt an, wann ein Paket neu gestartet werden kann. Mögliche Werte sind Never, IfExistsund Always. Der Standardwert dieser Eigenschaft ist Never, mit dem das Paket nicht neu gestartet werden kann. Weitere Informationen finden Sie unter DTSCheckpointUsage.
SaveCheckpoints Gibt an, ob die Prüfpunkte in die Prüfpunktdatei geschrieben werden, wenn das Paket ausgeführt wird. Der Standardwert dieser Eigenschaft ist False.

Hinweis

Das Festlegen der Prüfpunktausführungsoption /CheckPointing von dtexec auf „on“ entspricht der SaveCheckpoints -Eigenschaft des Pakets „True“ oder der CheckpointUsage -Eigenschaft „Immer“. Weitere Informationen finden Sie hier.

Ausführung

Mit den Eigenschaften in dieser Kategorie wird das Laufzeitverhalten des Paketobjekts konfiguriert.

Eigenschaft BESCHREIBUNG
DelayValidation Zeigt an, ob die Paketüberprüfung bis zur Ausführung des Pakets verschoben wird. Der Standardwert dieser Eigenschaft ist False.
Deaktivieren Zeigt an, ob das Paket deaktiviert ist. Der Standardwert dieser Eigenschaft ist False.
DisableEventHandlers Gibt an, ob die Paketereignishandler ausgeführt werden. Der Standardwert dieser Eigenschaft ist False.
FailPackageOnFailure Gibt an, ob das Paket bei einem Fehler in einer Paketkomponente fehlschlägt. Der einzige gültige Wert dieser Eigenschaft ist False.
FailParentOnError Gibt an, ob der übergeordnete Container bei einem Fehler in einem untergeordneten Container fehlschlägt. Der Standardwert dieser Eigenschaft ist False.
MaxConcurrentExecutables Die Anzahl von ausführbaren Dateien, die das Paket gleichzeitig ausführen kann. Der Standardwert dieser Eigenschaft ist -1, mit dem es kein Limit gibt.
MaximumErrorCount Die maximale zulässige Anzahl von Fehlern, nach der die Ausführung eines Pakets beendet wird. Der Standardwert dieser Eigenschaft ist 1.
PackagePriorityClass Die Win32-Threadprioritätsklasse des Paketthreads. Mögliche Werte sind Default, AboveNormal, Normal, BelowNormalund Idle. Der Standardwert dieser Eigenschaft ist Default. Weitere Informationen finden Sie unter DTSPriorityClass.

Erzwungener Ausführungswert

Mit den Eigenschaften in dieser Kategorie wird ein optionaler Ausführungswert für das Paket konfiguriert.

Eigenschaft BESCHREIBUNG
ForcedExecutionValue Ein Wert, der den vom Paket zurückgegebenen optionalen Ausführungswert angibt, falls ForceExecutionValue auf TRUEfestgelegt ist. Der Standardwert dieser Eigenschaft ist 0.
ForcedExecutionValueType Der Datentyp von ForcedExecutionValue. Der Standardwert dieser Eigenschaft ist Int32.
ForceExecutionValue Ein boolescher Wert, der angibt, ob ein bestimmter optionaler Ausführungswert des Containers erzwungen werden soll. Der Standardwert dieser Eigenschaft ist False.

Identifikation

Mit den Eigenschaften in dieser Kategorie werden Informationen bereitgestellt, wie z. B. der eindeutige Bezeichner und der Name des Pakets.

Eigenschaft BESCHREIBUNG
CreationDate Das Datum, an dem das Paket erstellt wurde.
CreatorComputerName Der Name des Computers, auf dem das Paket erstellt wurde.
CreatorName Der Name der Person, die das Paket erstellt hat.
Beschreibung Eine Beschreibung der Paketfunktionalität.
ID Der Paket-GUID, der dem Paket beim Erstellen zugewiesen wird. Diese Eigenschaft ist schreibgeschützt. Um einen neuen Zufallswert für die ID-Eigenschaft zu generieren, wählen Sie in der Dropdownliste <Neue ID generieren> aus.
Name Der Name des Pakets.
PackageType Der Pakettyp. Mögliche Werte sind Default, DTSDesigner, DTSDesigner100, DTSWizard, SQLDBMaintund SQLReplication. Der Standardwert dieser Eigenschaft ist Default. Weitere Informationen finden Sie unter DTSPackageType.

Sonstiges

Mit den Eigenschaften in dieser Kategorie wird auf Konfigurationen und Ausdrücke zugegriffen, die von einem Paket verwendet werden. Außerdem werden Informationen zum Gebietsschema und zum Protokollierungsmodus des Pakets bereitgestellt. Weitere Informationen finden Sie unter Verwenden von Eigenschaftsausdrücken in Paketen.

Eigenschaft BESCHREIBUNG
Konfigurationen Die Auflistung mit Konfigurationen, die vom Paket verwendet werden. Klicken Sie auf die Schaltfläche zum Durchsuchen (...) , um Paketkonfigurationen anzuzeigen und zu konfigurieren.
Ausdrücke Klicken Sie auf die Schaltfläche zum Durchsuchen (...) , um Ausdrücke für Paketeigenschaften zu erstellen.

Beachten Sie, dass Sie Eigenschaftsausdrücke für alle Paketeigenschaften dieses Objektmodells erstellen können, nicht nur für die im Eigenschaftenfenster aufgeführten Eigenschaften.

Weitere Informationen finden Sie unter Verwenden von Eigenschaftsausdrücken in Paketen.

Erweitern Sie Expressions, um vorhandene Eigenschaftsausdrücke anzuzeigen. Klicken Sie in einem Ausdruckstextfeld auf die Schaltfläche zum Durchsuchen (...) , um einen Ausdruck zu ändern und auszuwerten.
ForceExecutionResult Das Ausführungsergebnis des Pakets. Mögliche Werte sind None, Success, Failureund Completion. Der Standardwert dieser Eigenschaft ist None. Weitere Informationen finden Sie unter T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult.
LocaleId Ein Microsoft Win32-Gebietsschema. Der Standardwert dieser Eigenschaft ist das Gebietsschema des Betriebssystems auf dem lokalen Computer.
LoggingMode Ein Wert, der das Protokollierungsverhalten des Pakets angibt. Mögliche Werte sind Disabled, Enabledund UseParentSetting. Der Standardwert dieser Eigenschaft ist UseParentSetting. Weitere Informationen finden Sie unter DTSLoggingMode.
OfflineMode Gibt an, ob sich das Paket im Offlinemodus befindet. Diese Eigenschaft ist schreibgeschützt. Die Eigenschaft wird auf Projektebene festgelegt. Normalerweise versucht der SSIS -Designer eine Verbindung mit jeder Datenquellen herzustellen, die von dem Paket verwendet wird, um die den Quellen und Zielen zugeordneten Metadaten zu überprüfen. Wenn die Datenquellen nicht verfügbar sind, können Sie diese Verbindungsversuche und die resultierenden Überprüfungsfehler verhindern, indem Sie vor dem Öffnen eines Pakets im Menü SSIS die Option Offline arbeiten aktivieren. Sie können die Option Offline arbeiten auch aktivieren, um die Vorgänge im Designer zu beschleunigen, und sie lediglich zum Überprüfen des Pakets deaktivieren.
SuppressConfigurationWarnings Zeigt an, ob die von Konfigurationen generierten Warnungen unterdrückt werden. Der Standardwert dieser Eigenschaft ist False.
UpdateObjects Zeigt an, ob das Paket aktualisiert wird, um neuere Versionen der vorhandenen Objekte zu verwenden, falls neuere Versionen verfügbar sind. Beispielsweise wird ein Paket mit einem Masseneinfügungstask aktualisiert, wenn diese Eigenschaft auf TRUEfestgelegt ist, damit die neuere Version des Masseneinfügungstasks von Integration Services verwendet wird. Der Standardwert dieser Eigenschaft ist False.

Sicherheit

Mit den Eigenschaften in dieser Kategorie wird die Schutzebene des Pakets konfiguriert. Weitere Informationen finden Sie unter Access Control for Sensitive Data in Packages.

Eigenschaft BESCHREIBUNG
PackagePassword Das Kennwort für Paketschutzebenen (EncryptSensitiveWithPassword und EncryptAllWithPassword), die Kennwörter erfordern.
ProtectionLevel Die Schutzebene des Pakets. Mögliche Werte sind DontSaveSensitive, EncryptSensitiveWithUserKey, EncryptSensitiveWithPassword, EncryptAllWithPasswordund ServerStorage. Der Standardwert dieser Eigenschaft ist EncryptSensitiveWithUserKey. Weitere Informationen finden Sie unter DTSProtectionLevel.

Transaktionen

Mit den Eigenschaften in dieser Kategorie werden die Isolationsstufe und die Transaktionsoption des Pakets konfiguriert. Weitere Informationen finden Sie unter Integration Services-Transaktionen.

Eigenschaft BESCHREIBUNG
IsolationLevel Die Isolationsstufe der Pakettransaktionen. Mögliche Werte sind Unspecified, Chaos, ReadUncommitted, ReadCommitted, RepeatableReadSerializableund Snapshot. Der Standardwert dieser Eigenschaft ist Serializable.

Hinweis: Der Wert Momentaufnahme der Eigenschaft IsolationLevel ist mit Pakettransaktionen nicht kompatibel. Daher können Sie die IsolationLevel -Eigenschaft nicht verwenden, um die Isolationsstufe von Pakettransaktionen auf Shapshotfestzulegen. Verwenden Sie stattdessen eine SQL-Abfrage, um Pakettransaktionen auf Snapshot festzulegen. Weitere Informationen finden Sie unter TRANSAKTIONSISOLATIONSSTUFE EINSTELLEN (Transact-SQL).

Das System wendet die IsolationLevel -Eigenschaft nur dann auf Pakettransaktionen an, wenn der Wert der TransactionOption -Eigenschaft auf Requiredfestgelegt ist.

Der Wert der von einem untergeordneten Container angeforderten IsolationLevel -Eigenschaft wird ignoriert, wenn die folgenden Bedingungen erfüllt sind:
Der Wert der TransactionOption -Eigenschaft des untergeordneten Containers ist Supported.
Der untergeordnete Container nimmt an der Transaktion eines übergeordneten Containers teil.

Der Wert der vom Container angeforderten IsolationLevel -Eigenschaft wird nur berücksichtigt, wenn der Container eine neue Transaktion initiiert. Ein Container initiiert eine neue Transaktion, wenn die folgenden Bedingungen erfüllt sind:
Der Wert der TransactionOption -Eigenschaft des Containers ist Required.
Der übergeordnete Container hat nicht bereits eine Transaktion gestartet.



Weitere Informationen finden Sie unter IsolationLevel.
TransactionOption Die Transaktionsteilnahme des Pakets. Mögliche Werte sind NotSupported, Supportedund Required. Der Standardwert dieser Eigenschaft ist Supported. Weitere Informationen finden Sie unter DTSTransactionOption.

Version

Mit den Eigenschaften in dieser Kategorie werden Informationen zur Version des Paketobjekts bereitgestellt.

Eigenschaft BESCHREIBUNG
VersionBuild Die Versionsnummer des Paketbuilds.
VersionComments Kommentare zur Paketversion.
VersionGUID Der GUID der Paketversion. Diese Eigenschaft ist schreibgeschützt.
VersionMajor Die aktuelle Hauptversion des Pakets.
VersionMinor Die aktuelle Nebenversion des Pakets.

Festlegen von Paketeigenschaften im Fenster „Eigenschaften“

  1. Öffnen Sie in SQL Server Data Tools (SSDT)das Integration Services -Projekt mit dem Paket, das Sie konfigurieren möchten.

  2. Doppelklicken Sie im Bereich Projektmappen-Explorerauf das Paket, um es im SSIS -Designer zu öffnen, oder klicken Sie mit der rechten Maustaste, und wählen Sie Sicht-Designeraus.

  3. Klicken Sie auf die Registerkarte Ablaufsteuerung , und führen Sie eine der folgenden Aktionen aus:

    • Klicken Sie mit der rechten Maustaste an einer beliebigen Stelle im Hintergrund der Entwurfsoberfläche der Ablaufsteuerung, und klicken Sie anschließend auf Eigenschaften.

    • Klicken Sie im Menü Ansicht auf Eigenschaftenfenster.

  4. Bearbeiten Sie die Paketeigenschaften im Fenster Eigenschaften .

  5. Klicken Sie im Menü Datei auf Ausgewählte Elemente speichern , um das aktualisierte Paket zu speichern.