次の方法で共有

パッケージのプロパティを設定する

  • [アーティクル]

SQL Server Data Tools (SSDT) のグラフィカル インターフェイスを使用して Integration Services のパッケージを作成する場合、パッケージ オブジェクトのプロパティは [プロパティ] ウィンドウで設定します。

[プロパティ] ウィンドウでは、プロパティが分類され、アルファベット順で一覧が提供されます。 [プロパティ] ウィンドウの表示をカテゴリ別に並べ替えるには、[項目別] アイコンをクリックします。

カテゴリ別に並べ替えると、 [プロパティ] ウィンドウは、プロパティを次のカテゴリにグループ化します。

[プロパティ] ウィンドウで設定できないパッケージの追加プロパティの詳細については、「Package」を参照してください。

[プロパティ] ウィンドウでパッケージのプロパティを設定するには

カテゴリ別プロパティ

次の表は、パッケージのプロパティをカテゴリ別に一覧表示しています。

チェックポイント

このカテゴリのプロパティを使用すると、パッケージ制御フローで障害が発生した時点からパッケージを再開できます。制御フローの最初からパッケージを再実行する必要はありません。 詳細については、「チェックポイントを使用してパッケージを再開する」を参照してください。

プロパティ 説明
CheckpointFileName パッケージを再開するチェックポイントに関する情報をキャプチャする、ファイルの名前です。 パッケージが正常に完了すると、このファイルは削除されます。
CheckpointUsage パッケージが再開できる時点を指定します。 値は、Never、IfExists、および Always です。 このプロパティの既定値は、パッケージを再起動できないことを示す Never です。 詳細については、「DTSCheckpointUsage」を参照してください。
SaveCheckpoints パッケージの実行時にチェックポイントをチェックポイント ファイルに書き込むかどうかを指定します。 このプロパティの既定値は False です。

注意

dtexec の /CheckPointing on オプションを使用すると、パッケージの SaveCheckpoints プロパティを True に設定した場合、および CheckpointUsage プロパティを Always に設定した場合と同等の効果が得られます。 詳細については、「dtexec ユーティリティ」を参照してください。

実行

このカテゴリのプロパティは、パッケージ オブジェクトの実行時の動作を構成します。

プロパティ 説明
DelayValidation パッケージの実行時までパッケージの検証を遅らせるかどうかを示します。 このプロパティの既定値は、False です。
Disable パッケージを無効にするかどうかを示します。 このプロパティの既定値は False です。
DisableEventHandlers パッケージのイベント ハンドラーを実行するかどうかを示します。 このプロパティの既定値は False です。
FailPackageOnFailure パッケージ コンポーネント内でエラーが発生した場合、パッケージが失敗するかどうかを示します。 このプロパティの有効な値は、False だけです。
FailParentOnError 子コンテナーでエラーが発生した場合、親コンテナーが失敗するかどうかを示します。 このプロパティの既定値は False です。
MaxConcurrentExecutables パッケージが同時実行できる実行可能ファイルの数を示します。 このプロパティの既定値は、パッケージを再起動できないことを示す -1です。これは、ファイル数に制限がないことを示します。
MaximumErrorCount パッケージが実行を停止するまでに発生が許可される、最大エラー数を示します。 このプロパティの既定値は 1です。
PackagePriorityClass パッケージ スレッドの Win32 スレッド優先度クラスを示します。 値は、Default、AboveNormal、Normal、BelowNormal、および Idle です。 このプロパティの既定値は Default です。 詳細については、DTSPriorityClass を参照してください。

強制実行値

このカテゴリのプロパティは、パッケージのオプションの実行値を構成します。

プロパティ 説明
ForcedExecutionValue ForceExecutionValue が に True設定されている場合、パッケージから返される省略可能な実行値を指定する値。 このプロパティの既定値は 0です。
ForcedExecutionValueType ForcedExecutionValue のデータ型。 このプロパティの既定値は Int32 です。
ForceExecutionValue コンテナーのオプションの実行値に特定の値を適用する必要があるかどうかを示すブール値です。 このプロパティの既定値は False です。

識別

このカテゴリのプロパティは、パッケージの一意識別子や名前などの情報を提供します。

プロパティ 説明
CreationDate パッケージが作成された日付です。
CreatorComputerName パッケージが作成されたコンピューターの名前です。
CreatorName パッケージの作成者の名前です。
Description パッケージ機能の説明です。
ID パッケージ GUID です。パッケージが作成されるときに割り当てられます。 このプロパティは読み取り専用です。 プロパティの新しいランダムな値をID生成するには、ドロップダウン リストで [新しい ID の生成] を>選択<します。
Name パッケージの名前です。
PackageType パッケージの種類です。 値は、Default、DTSDesigner、DTSDesigner100、DTSWizard、SQLDBMaint、および SQLReplication です。 このプロパティの既定値は Default です。 詳細については、DTSPackageType を参照してください。

その他

このカテゴリのプロパティは、パッケージで使用する構成と式にアクセスし、パッケージのロケールとログ モードに関する情報を提供するために使用されます。 詳細については、「 パッケージでプロパティ式を使用する」を参照してください。

プロパティ 説明
Configurations パッケージで使用する構成のコレクションです。 パッケージ構成を表示して構成するには、参照ボタン ( [...] ) をクリックします。
Expressions パッケージのプロパティの式を作成するには、参照ボタン ( [...] ) をクリックします。

注: プロパティ ウィンドウにリストされているプロパティだけでなく、オブジェクト モデルに含まれるすべてのパッケージ プロパティのプロパティ式を作成できます。

詳細については、「 パッケージでプロパティ式を使用する」を参照してください。

既存のプロパティの式を表示するには、Expressions を展開します。 式を変更したり評価するには、式テキスト ボックスの参照ボタン ( [...] ) をクリックします。
ForceExecutionResult パッケージの実行結果です。 有効値は、None、Success、Failure、および Completion です。 このプロパティの既定値は None です。 詳細については、「T:Microsoft.SqlServer.Dts.Runtime.DTSForcedExecResult」を参照してください。
LocaleId Microsoft Win32 ロケールです。 このプロパティの既定値は、ローカル コンピューター上のオペレーティング システムのロケールです。
LoggingMode パッケージのログ記録の動作を指定する値です。 値は、Disabled、Enabled、および UseParentSetting です。 このプロパティの既定値は UseParentSetting です。 詳細については、「DTSLoggingMode」を参照してください。
OfflineMode パッケージがオフライン モードかどうかを示します。 このプロパティは読み取り専用です。 プロジェクト レベルで設定されます。 通常、 SSIS デザイナーは、変換元と変換先に関連付けられたメタデータを検証するとき、パッケージで使用される各データ ソースに接続を試みます。 [SSIS] メニューの [オフライン作業] を有効にすると、パッケージを開く前でも、データ ソースを使用できないときに、接続を試行したり検証エラーが返されたりするのを防ぐことができます。 また、 [オフライン作業] を有効にしてデザイナーでの操作を高速化し、パッケージを検証するときだけこのオプションを無効にすることもできます。
SuppressConfigurationWarnings 構成によって生成された警告を表示しないかどうかを示します。 このプロパティの既定値は False です。
UpdateObjects パッケージに含まれるオブジェクトの新しいバージョンが使用できるようになった場合に、パッケージを更新して、そのオブジェクトの新バージョンを使用するかどうかを示します。 たとえば、このプロパティが に True設定されている場合、Integration Services が提供する新しいバージョンの一括挿入タスクを使用するように、一括挿入タスクを含むパッケージが更新されます。 このプロパティの既定値は False です。

セキュリティ

このカテゴリのプロパティを使用すると、パッケージの保護レベルが設定されます。 詳しくは、「 Access Control for Sensitive Data in Packages」をご覧ください。

プロパティ 説明
PackagePassword パスワードを必要とするパッケージ保護レベル (EncryptSensitiveWithPassword および EncryptAllWithPassword) のパスワード。
ProtectionLevel パッケージの保護レベルです。 値は、DontSaveSensitive、EncryptSensitiveWithUserKey、、EncryptAllWithPasswordEncryptSensitiveWithPasswordおよび ServerStorage です。 このプロパティの既定値は EncryptSensitiveWithUserKey です。 詳細については、DTSProtectionLevel を参照してください。

トランザクション

このカテゴリのプロパティは、パッケージの分離レベルとトランザクション オプションを構成します。 詳細については、「 Integration Services のトランザクション」をご覧ください。

プロパティ 説明
IsolationLevel パッケージ トランザクションの分離レベルです。 このプロパティの既定値は Serializable です。 有効な値は、次のとおりです。
Unspecified
Chaos
ReadUncommitted
ReadCommitted
RepeatableRead
Serializable
Snapshot.

IsolationLevel プロパティは、TransactionOption プロパティの値が Required の場合にのみ、パッケージ トランザクションに適用されます。

子コンテナーによって要求された IsolationLevel プロパティの値は、以下の場合には無視されます。

子コンテナーの TransactionOption プロパティの値が Supported である場合。
子コンテナーが親コンテナーのトランザクションに参加する場合。

コンテナーによって要求された IsolationLevel プロパティの値は、コンテナーが新しいトランザクションを開始する場合にのみ利用されます。 コンテナーは、次の場合に新しいトランザクションを開始します。

コンテナーの TransactionOption プロパティの値が Required である場合。
親がまだトランザクションを開始していない場合。



注: IsolationLevel プロパティの値 Snapshot は、パッケージ トランザクションと互換性がありません。 したがって、IsolationLevel プロパティを使用して、パッケージ トランザクションの分離レベルを Shapshot に設定することはできません。 SQL クエリを使用して、パッケージ トランザクションを Snapshot に設定してください。 詳細については、「SET TRANSACTION ISOLATION LEVEL (Transact-SQL)」を参照してください。

IsolationLevel プロパティの詳細については、「IsolationLevel」を参照してください。
TransactionOption パッケージに対するトランザクションの関与を示します。 値は、 NotSupported、 Supported、です Required。 このプロパティの既定値は Supported です。 詳細については、DTSTransactionOption を参照してください。

バージョン

このカテゴリのプロパティは、パッケージ オブジェクトのバージョンに関する情報を提供します。

プロパティ 説明
VersionBuild パッケージのビルドのバージョン番号です。
VersionComments パッケージのバージョンに関するコメントです。
VersionGUID パッケージのバージョンの GUID です。 このプロパティは読み取り専用です。
VersionMajor パッケージの最新のメジャー バージョン。
VersionMinor パッケージの最新のマイナー バージョン。