Festlegen von Paketeigenschaften

  • Artikel

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, IfExists und 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 on von dtexec 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, BelowNormal und 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 Wenn ForceExecutionValue auf Truefestgelegt ist, ist ein Wert, der den optionalen Ausführungswert angibt, den das Paket zurückgibt. 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.
Description Eine Beschreibung der Paketfunktionalität.
ID Der Paket-GUID, der dem Paket beim Erstellen zugewiesen wird. Diese Eigenschaft ist schreibgeschützt. Um einen neuen zufälligen Wert 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, SQLDBMaint und 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
Configurations Die Auflistung mit Konfigurationen, die vom Paket verwendet werden. Klicken Sie auf die Schaltfläche zum Durchsuchen (...) , um Paketkonfigurationen anzuzeigen und zu konfigurieren.
Expressions Klicken Sie auf die Schaltfläche zum Durchsuchen (...) , um Ausdrücke für Paketeigenschaften zu erstellen.

Hinweis: Sie können Eigenschaftenausdrücke für alle Paketeigenschaften erstellen, die das Objektmodell enthält, 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, Failure und 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, Enabled und 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. Wenn diese Eigenschaft beispielsweise auf Truefestgelegt ist, wird ein Paket, das einen Masseneinfügevorgang enthält, aktualisiert, um die neuere Version des Masseneinfügungstasks zu verwenden, den Integration Services bereitstellt. 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), für die Kennwörter erforderlich sind.
ProtectionLevel Die Schutzebene des Pakets. Die Werte sind DontSaveSensitive, , EncryptSensitiveWithPasswordEncryptSensitiveWithUserKey, 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. Der Standardwert dieser Eigenschaft ist Serializable. Folgende Werte sind gültig:
Unspecified
Chaos
ReadUncommitted
ReadCommitted
RepeatableRead
Serializable
Snapshot.

Das System wendet die IsolationLevel-Eigenschaft nur dann auf Pakettransaktionen an, wenn der Wert der TransactionOption-Eigenschaft auf Required festgelegt 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.



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

Weitere Informationen zur IsolationLevel-Eigenschaft finden Sie unter IsolationLevel.
TransactionOption Die Transaktionsteilnahme des Pakets. Die Werte sind NotSupported, Supported, . 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.