パッケージのプロパティを設定する
適用対象: 
SQL Server Azure Data Factory の SSIS 統合ランタイム
SQL Server Data Tools (SSDT) のグラフィカル インターフェイスを使用して Integration Services のパッケージを作成する場合、パッケージ オブジェクトのプロパティは [プロパティ] ウィンドウで設定します。
[プロパティ] ウィンドウでは、プロパティが分類され、アルファベット順で一覧が提供されます。 [プロパティ] ウィンドウの表示をカテゴリ別に並べ替えるには、[項目別] アイコンをクリックします。
カテゴリ別に並べ替えると、 [プロパティ] ウィンドウは、プロパティを次のカテゴリにグループ化します。
[プロパティ] ウィンドウで設定できないパッケージの追加プロパティの詳細については、「Package」を参照してください。
[プロパティ] ウィンドウでパッケージのプロパティを設定するには
カテゴリ別プロパティ
次の表は、パッケージのプロパティをカテゴリ別に一覧表示しています。
チェックポイント
このカテゴリのプロパティを使用すると、パッケージ制御フローで障害が発生した時点からパッケージを再開できます。制御フローの最初からパッケージを再実行する必要はありません。 詳細については、「チェックポイントを使用してパッケージを再開する」を参照してください。
| プロパティ | 説明 |
|---|---|
| CheckpointFileName | パッケージを再開するチェックポイントに関する情報をキャプチャする、ファイルの名前です。 パッケージが正常に完了すると、このファイルは削除されます。 |
| CheckpointUsage | パッケージが再開できる時点を指定します。 値は、 Never、 IfExists、および 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 スレッド優先度クラスを示します。 値は、 Default、 AboveNormal、 Normal、 BelowNormal、および Idleです。 このプロパティの既定値は Defaultです。 詳細については、DTSPriorityClass を参照してください。 |
強制実行値
このカテゴリのプロパティは、パッケージのオプションの実行値を構成します。
| プロパティ | 説明 |
|---|---|
| ForcedExecutionValue | ForceExecutionValue を Trueに設定すると、値は、パッケージが返すオプションの実行値を示します。 このプロパティの既定値は 0です。 |
| ForcedExecutionValueType | ForcedExecutionValue のデータ型。 このプロパティの既定値は Int32です。 |
| ForcedExecutionValue | コンテナーのオプションの実行値に特定の値を適用する必要があるかどうかを示すブール値です。 このプロパティの既定値は Falseです。 |
識別
このカテゴリのプロパティは、パッケージの一意識別子や名前などの情報を提供します。
| プロパティ | 説明 |
|---|---|
| CreationDate | パッケージが作成された日付です。 |
| CreatorComputerName | パッケージが作成されたコンピューターの名前です。 |
| CreatorName | パッケージの作成者の名前です。 |
| 説明 | パッケージ機能の説明です。 |
| ID | パッケージ GUID です。パッケージが作成されるときに割り当てられます。 このプロパティは読み取り専用です。 ID プロパティの新しい値をランダムに生成するには、ドロップダウン リストで [<新しい ID の設定>] を選択します。 |
| Name | パッケージの名前です。 |
| PackageType | パッケージの種類です。 値は、 Default、 DTSDesigner、 DTSDesigner100、 DTSWizard、 SQLDBMaint、および SQLReplicationです。 このプロパティの既定値は Defaultです。 詳細については、DTSPackageType を参照してください。 |
その他
このカテゴリのプロパティは、パッケージで使用する構成と式にアクセスし、パッケージのロケールとログ モードに関する情報を提供するために使用されます。 詳細については、「 パッケージでプロパティ式を使用する」を参照してください。
| プロパティ | 説明 |
|---|---|
| 構成 | パッケージで使用する構成のコレクションです。 パッケージ構成を表示して構成するには、参照ボタン ( [...] ) をクリックします。 |
| 式 | パッケージのプロパティの式を作成するには、参照ボタン ( [...] ) をクリックします。 [プロパティ] ウィンドウに一覧表示されるプロパティだけでなく、オブジェクト モデルに含まれるすべてのパッケージのプロパティの式が作成できます。 詳細については、「 パッケージでプロパティ式を使用する」を参照してください。 既存のプロパティの式を表示するには、 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、 EncryptSensitiveWithPassword、 EncryptAllWithPassword、および ServerStorageです。 このプロパティの既定値は EncryptSensitiveWithUserKeyです。 詳細については、DTSProtectionLevel を参照してください。 |
トランザクション
このカテゴリのプロパティは、パッケージの分離レベルとトランザクション オプションを構成します。 詳細については、「 Integration Services のトランザクション」をご覧ください。
| プロパティ | 説明 |
|---|---|
| IsolationLevel | パッケージ トランザクションの分離レベルです。 値は、 Unspecified、 Chaos、 ReadUncommitted、 ReadCommitted、 RepeatableRead、 Serializable、および Snapshotです。 このプロパティの既定値は Serializableです。 注: IsolationLevel プロパティの値 Snapshot は、パッケージ トランザクションと互換性がありません。 したがって、 IsolationLevel プロパティを使用して、パッケージ トランザクションの分離レベルを Shapshotに設定することはできません。 代わりに、SQL クエリを使用して、パッケージ トランザクションをスナップショットに設定します。 詳細については、「SET TRANSACTION ISOLATION LEVEL (Transact-SQL)」を参照してください。 IsolationLevel プロパティは、 TransactionOption プロパティの値が Requiredの場合にのみ、パッケージ トランザクションに適用されます。 子コンテナーによって要求された IsolationLevel プロパティの値は、以下の場合には無視されます。 子コンテナーの TransactionOption プロパティの値が Supportedである場合。 子コンテナーが親コンテナーのトランザクションに参加する場合。 コンテナーによって要求された IsolationLevel プロパティの値は、コンテナーが新しいトランザクションを開始する場合にのみ利用されます。 コンテナーは、次の場合に新しいトランザクションを開始します。 コンテナーの TransactionOption プロパティの値が Requiredである場合。 親がまだトランザクションを開始していない場合。 詳細については、IsolationLevel を参照してください。 |
| TransactionOption | パッケージに対するトランザクションの関与を示します。 値は、 NotSupported、 Supported、および Requiredです。 このプロパティの既定値は Supportedです。 詳細については、DTSTransactionOption を参照してください。 |
バージョン
このカテゴリのプロパティは、パッケージ オブジェクトのバージョンに関する情報を提供します。
| プロパティ | 説明 |
|---|---|
| VersionBuild | パッケージのビルドのバージョン番号です。 |
| VersionComments | パッケージのバージョンに関するコメントです。 |
| VersionGUID | パッケージのバージョンの GUID です。 このプロパティは読み取り専用です。 |
| VersionMajor | パッケージの最新のメジャー バージョン。 |
| VersionMinor | パッケージの最新のマイナー バージョン。 |
[プロパティ] ウィンドウでパッケージのプロパティを設定する
SQL Server Data Tools (SSDT)で、構成するパッケージが含まれている Integration Services プロジェクトを開きます。
ソリューション エクスプローラーで、パッケージをダブルクリックして SSIS デザイナーで開くか、右クリックして [ビュー デザイナー] を選択します。
[制御フロー] タブをクリックし、次のいずれかの操作を行います。
制御フローのデザイン画面の背景で任意の場所を右クリックし、 [プロパティ] をクリックします。
[表示] メニューの [プロパティ ウィンドウ] をクリックします。
[プロパティ] ウィンドウで、パッケージのプロパティを編集します。
[ファイル] メニューの [選択されたファイルを上書き保存] をクリックし、更新したパッケージを保存します。