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

  • [アーティクル]

更新 : 2006 年 7 月 17 日

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

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

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

  • チェックポイント
  • 実行
  • 強制実行値
  • 識別
  • その他
  • セキュリティ
  • トランザクション
  • バージョン

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

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

カテゴリ別プロパティ

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

チェックポイント

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

プロパティ 説明

CheckpointFileName

パッケージを再開するチェックポイントに関する情報をキャプチャする、ファイルの名前です。パッケージが正常に完了すると、このファイルは削除されます。

CheckpointUsage

パッケージが再開できる時点を指定します。値は、Never、IfExists、および Always です。このプロパティの既定値は Never です。これは、パッケージが再開できないことを示します。詳細については、「DTSCheckpointUsage」を参照してください。

SaveCheckpoints

パッケージの実行時にチェックポイントをチェックポイント ファイルに書き込むかどうかを指定します。このプロパティの既定値は False です。
ms137749.note(ja-jp,SQL.90).gifメモ :
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 のデータ型です。

ForceExecutionValue

パッケージの実行値が強制されるかどうかを示します。このプロパティの既定値は False です。

識別

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

プロパティ 説明

CreationDate

パッケージが作成された日付です。

CreatorComputerName

パッケージが作成されたコンピュータの名前です。

CreatorName

パッケージの作成者の名前です。

Description

パッケージ機能の説明です。

ID

パッケージ GUID です。パッケージが作成されるときに割り当てられます。このプロパティは読み取り専用です。ID プロパティの新しい値をランダムに生成するには、ドロップダウン リストで [<Generate New ID>] を選択します。

Name

パッケージの名前です。

PackageType

パッケージの種類です。値は、Default、DTSDesigner、DTSDesigner90、DTSWizard、SQLDBMaint、および SQLReplication です。このプロパティの既定値は Default です。詳細については、「DTSPackageType」を参照してください。

その他

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

プロパティ

説明

Configurations

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

Expressions

パッケージのプロパティの式を作成するには、参照ボタン ([...]) をクリックします。

ms137749.note(ja-jp,SQL.90).gifメモ :

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

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

既存のプロパティの式を表示するには、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 です。

セキュリティ

このカテゴリのプロパティを使用すると、パッケージの保護レベルが設定されます。詳細については、「パッケージの保護レベルの設定」を参照してください。

プロパティ 説明

PackagePassword

パスワードを必要とするパッケージの保護レベル (EncryptSensitiveWithPassword および EncryptAllWithPassword) のパスワードです。

ProtectionLevel

パッケージの保護レベルです。値は、DontSaveSensitive、EncryptSensitiveWithUserKey、EncryptSensitiveWithPassword、EncryptAllWithPassword、および ServerStorage です。このプロパティの既定値は EncryptSensitiveWithUserKey です。詳細については、「DTSProtectionLevel」を参照してください。

トランザクション

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

プロパティ 説明

IsolationLevel

パッケージ トランザクションの分離レベルです。値は、Unspecified、Chaos、ReadUncommitted、ReadCommitted、RepeatableRead、Serializable、および Snapshot です。このプロパティの既定値は Serializable です。詳細については、「IsolationLevel」を参照してください。

TransactionOption

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

バージョン

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

プロパティ 説明

VersionBuild

パッケージのビルドのバージョン番号です。

VersionComments

パッケージのバージョンに関するコメントです。

VersionGUID

パッケージのバージョンの GUID です。このプロパティは読み取り専用です。

VersionMajor

パッケージの最新メジャー バージョンです。

VersionMinor

パッケージの最新マイナ バージョンです。

参照

その他の技術情報

SSIS デザイナでのパッケージの作成

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース 履歴

2006 年 7 月 17 日
変更内容 :
  • オフライン作業を使用して検証エラーを防ぐ方法に関する情報を追加しました。

2006 年 4 月 14 日
変更内容 :
  • 新しい ForceExecutionResult プロパティの情報を追加しました。