Festlegen von Paketeigenschaften

Artikel
05/07/2013

Wenn Sie ein Paket in SQL Server-Datentools (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:

Prüfpunkte
Ausführung
Erzwungener Ausführungswert
Identifikation
Sonstiges
Sicherheit
Transaktionen
Version

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.

Festlegen der Eigenschaften eines Pakets

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
Die Verwendung von dtexec mit der Option /CheckPointing on entspricht dem Festlegen der Eigenschaften SaveCheckpoints und CheckpointUsage für das Paket auf die Werte "True" bzw. "Always". Weitere Informationen finden Sie unter dtexec (Hilfsprogramm).

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.
Disable	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	Ein Wert, der den vom Paket zurückgegebenen optionalen Ausführungswert angibt, falls ForceExecutionValue auf True festgelegt 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.
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 Zufallswert für die ID-Eigenschaft zu generieren, wählen Sie <Neue ID generieren> in der Dropdownliste 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.

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 Eigenschaftsausdrücke für alle Paketeigenschaften dieses Objektmodells erstellen, 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 mit den drei Punkten (…), 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

Zeigt 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 True festgelegt 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 Zugriffssteuerung für vertrauliche Daten in Paketen.

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, EncryptAllWithPassword und 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.

IsolationLevel

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

Der Snapshot-Wert der IsolationLevel-Eigenschaft 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 SET TRANSACTION ISOLATION LEVEL (Transact-SQL).

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.

Weitere Informationen finden Sie unter IsolationLevel.

TransactionOption

Die Transaktionsteilnahme des Pakets. Mögliche Werte sind NotSupported, Supported und 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.

Bleiben Sie mit Integration Services auf dem neuesten Stand

Die neuesten Downloads, Artikel, Beispiele und Videos von Microsoft sowie ausgewählte Lösungen aus der Community finden Sie auf MSDN auf der Integration Services-Seite:

Besuchen Sie die Integration Services-Seite auf MSDN

Abonnieren Sie die auf der Seite verfügbaren RSS-Feeds, um automatische Benachrichtigungen zu diesen Updates zu erhalten.