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

適用対象:SQL Server Azure Data Factory の SSIS Integration Runtime

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

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

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

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

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

カテゴリ別プロパティ

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

チェックポイント

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

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

Note

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

実行

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

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

強制実行値

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

プロパティ 説明
ForcedExecutionValue ForceExecutionValue を Trueに設定すると、値は、パッケージが返すオプションの実行値を示します。 このプロパティの既定値は 0です。
ForcedExecutionValueType ForcedExecutionValue のデータ型。 このプロパティの既定値は Int32です。
ForcedExecutionValue コンテナーのオプションの実行値に特定の値を適用する必要があるかどうかを示すブール値です。 このプロパティの既定値は Falseです。

識別

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

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

その他

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

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

[プロパティ] ウィンドウに一覧表示されるプロパティだけでなく、オブジェクト モデルに含まれるすべてのパッケージのプロパティの式が作成できます。

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

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

セキュリティ

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

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

トランザクション

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

プロパティ 説明
IsolationLevel パッケージ トランザクションの分離レベルです。 値は、 UnspecifiedChaosReadUncommittedReadCommittedRepeatableReadSerializable、および Snapshotです。 このプロパティの既定値は Serializableです。

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

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

子コンテナーによって要求された IsolationLevel プロパティの値は、以下の場合には無視されます。
子コンテナーの TransactionOption プロパティの値が Supportedである場合。
子コンテナーが親コンテナーのトランザクションに参加する場合。

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



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

バージョン

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

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

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

  1. SQL Server Data Tools (SSDT)で、構成するパッケージが含まれている Integration Services プロジェクトを開きます。

  2. ソリューション エクスプローラーで、パッケージをダブルクリックして SSIS デザイナーで開くか、右クリックして [ビュー デザイナー] を選択します。

  3. [制御フロー] タブをクリックし、次のいずれかの操作を行います。

    • 制御フローのデザイン画面の背景で任意の場所を右クリックし、 [プロパティ] をクリックします。

    • [表示] メニューの [プロパティ ウィンドウ] をクリックします。

  4. [プロパティ] ウィンドウで、パッケージのプロパティを編集します。

  5. [ファイル] メニューの [選択されたファイルを上書き保存] をクリックし、更新したパッケージを保存します。