Festlegen von Paketeigenschaften

Wenn Sie ein Paket in Business Intelligence Development Studio 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.

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 Verwenden von Prüfpunkten in Paketen.

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.

HinweisHinweis

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 (Dienstprogramm).

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 Verwendung von Eigenschaftsausdrücken in Paketen.

Eigenschaft

Beschreibung

Configurations

Die Auflistung mit Konfigurationen, die vom Paket verwendet werden. Klicken Sie auf die Schaltfläche mit den drei Punkten (…), um Paketkonfigurationen anzuzeigen und zu konfigurieren.

Expressions

Klicken Sie auf die Schaltfläche mit den drei Punkten (…), um Ausdrücke für Paketeigenschaften zu erstellen.

HinweisHinweis
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 Verwendung 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 Festlegen der Paketschutzebene.

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 Integrieren von Transaktionen in Pakete.

Eigenschaft

Beschreibung

IsolationLevel

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

HinweisHinweis
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.

Integration Services (kleines Symbol) 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 der Integration Services-Seite von MSDN oder TechNet:

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

Änderungsverlauf

Der Inhalt wurde aktualisiert.

  • Die Erläuterung der Werte in der Kategorie Erzwungener Ausführungswert wurde aktualisiert.

  • Es wird erklärt, wie die TransactionOption-Eigenschaft beeinflusst, ob der von einem Container angeforderte Wert der IsolationLevel-Eigenschaft ignoriert wird.

  • Hinweis hinzugefügt, in dem erläutert wird, warum die IsolationLevel-Eigenschaft nicht zum Festlegen einer Pakettransaktion auf Snapshot verwendet werden kann.