dtexec ユーティリティ (SSIS ツール)

/CheckF[ile]filespec

(省略可)。パッケージの CheckpointFileName プロパティが、filespec で指定されたパスおよびファイルに設定されます。このファイルは、パッケージが再起動されたときに使用されます。このオプションが指定されていて、ファイル名の値が指定されていない場合、パッケージの CheckpointFileName には空の文字列が設定されます。このオプションが指定されない場合、パッケージの値は保持されます。

/Com[mandFile]filespec

(省略可)。ユーティリティのコマンド初期フェーズ時に、filespec で指定されたファイルを開き、ファイルに EOF が見つかるまでそのファイルの変換元オプションの処理を続行します。filespec に指定されるのは、追加の dtexec コマンド オプションを含んでいるテキスト ファイルです。filespec 引数には、パッケージの実行に関連付けるコマンド ファイルのファイル名とパスを指定します。

/Conn[ection]id_or_name;connection_string [[;id_or_name;connection_string] ]

(省略可)。指定した名前または GUID の接続マネージャーがパッケージ内にあり、接続文字列が指定されていることを示します。

このオプションでは、接続マネージャーの名前または GUID を指定する id_or_name 引数と、有効な接続文字列を指定する connection_string 引数の両方のパラメーターが必須です。詳細については、「Integration Services の接続」を参照してください。

実行時に /Connection オプションを使用すると、デザイン時に指定した場所とは別の場所からパッケージ構成を読み込むことができます。デザイン時に指定した値は、それらの構成の値で置き換えられます。ただし、/Connection オプションを使用できるのは、接続マネージャーを使用する構成 (SQL Server 構成など) だけです。パッケージ構成が適用されるしくみについては、「SSIS パッケージ構成」および「SQL Server 2008 R2 における Integration Services 機能の動作の変更」を参照してください。

/D[ts]package_path

(省略可)。SSIS パッケージ ストアからパッケージを読み込みます。package_path 引数には、SSIS パッケージの相対パスを指定します。このパスは SSIS パッケージ ストアのルートから始まり、SSIS パッケージの名前を含むパスです。package_path 引数に指定するパスまたはファイル名に空白文字を含める場合は、package_path 引数を引用符で囲む必要があります。

/DTS オプションは、/File オプションまたは /SQL オプションと共に使用することはできません。複数のオプションが指定された場合、dtexec は失敗します。

/Dumperror code

(省略可)。パッケージの実行中に指定のイベントが 1 つ以上発生した場合に、デバッグ ダンプ ファイル (.mdmp および .tmp) を作成します。error code 引数では、システムによるデバッグ ダンプ ファイル作成のトリガーとなるイベント コードの種類 (エラー、警告、または情報) を指定します。イベント コードを複数指定するには、各 error code 引数をセミコロン (;) で区切ります。

Integration Services の既定では、デバッグ ダンプ ファイルは <drive>:\Program Files\Microsoft SQL Server\100\Shared\ErrorDumps フォルダーに格納されます。

注

デバッグ ダンプ ファイルには機密情報が含まれている場合があります。アクセス制御リスト (ACL) を使用してファイルへのアクセスを制限するか、アクセスが制限されたフォルダーにファイルをコピーしてください。たとえば、デバッグ ファイルを Microsoft サポート サービスに送信する前には、機密性の高い情報をすべて削除することをお勧めします。

dtexec ユーティリティで実行するすべてのパッケージにこのオプションを適用するには、DumpOnCodes REG_SZ 値をレジストリ キー HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DtsPath に追加します。DumpOnCodes のデータ値では、システムによるデバッグ ダンプ ファイル作成のトリガーとなるエラー コードを指定します。複数のエラー コードは、セミコロン (;) で区切る必要があります。

DumpOnCodes 値をレジストリ キーに追加し、/Dump オプションも使用した場合、両方の設定に基づくデバッグ ダンプ ファイルが作成されます。

デバッグ ダンプ ファイルの詳細については、「デバッグ ダンプ ファイルの操作」を参照してください。

/F[ile]filespec

(省略可)。ファイル システムに保存されているパッケージを読み込みます。filespec 引数には、パッケージのパスとファイル名を指定します。汎用名前付け規則 (UNC) 形式のパス、またはローカル パスのどちらかでパスを指定できます。filespec 引数に指定するパスまたはファイル名に空白文字を含める場合は、filespec 引数を引用符で囲む必要があります。

/File オプションは、/DTS オプションまたは /SQL オプションと共に使用することはできません。複数のオプションが指定された場合、dtexec は失敗します。

/L[ogger]classid_orprogid;configstring

(省略可)。1 つまたは複数のログ プロバイダーを SSIS パッケージの実行と関連付けます。classid_orprogid パラメーターには、ログ プロバイダーを指定します。指定できるのはクラス GUID です。configstring は、ログ プロバイダーを構成するために使用する文字列です。

使用できるログ プロバイダーは次のとおりです。

• テキスト ファイル:

  • ProgID: DTS.LogProviderTextFile.1

  • ClassID: {59B2C6A5-663F-4C20-8863-C83F9B72E2EB}

• SQL Server Profiler:

  • ProgID: DTS.LogProviderSQLProfiler.1

  • ClassID: {5C0B8D21-E9AA-462E-BA34-30FF5F7A42A1}

• SQL Server:

  • ProgID: DTS.LogProviderSQLServer.1

  • ClassID: {6AA833A1-E4B2-4431-831B-DE695049DC61}

• Windows イベント ログ:

  • ProgID: DTS.LogProviderEventLog.1

  • ClassID: {97634F75-1DC7-4F1F-8A4C-DAF0E13AAA22}

• XML ファイル:

  • ProgID: DTS.LogProviderXMLFile.1

  • ClassID: {AFED6884-619C-484F-9A09-F42D56E1A7EA}

/P[assword]password

(省略可)。SQL Server 認証によって保護されているパッケージの取得を可能にします。このオプションは、/User オプションと共に使用します。/Password オプションを省略して /User オプションを使用する場合、空白のパスワードが使用されます。password 値は引用符で囲むことができます。

セキュリティに関する注意

可能な場合は、Windows 認証を使用します。

/Rep[orting]level [;event_guid_or_name[;event_guid_or_name[...]]

(省略可)。レポートするメッセージの種類を指定します。level に使用できるレポート オプションは次のとおりです。

N   レポートしません。

E   エラーがレポートされます。

W   警告がレポートされます。

I   情報メッセージがレポートされます。

C   カスタム イベントがレポートされます。

D   データ フロー タスク イベントがレポートされます。

P   進行状況がレポートされます。

V   詳細がレポートされます。

V および N の引数は、他のすべての引数と同時には使用できないため、単独で指定する必要があります。/Reporting オプションが指定されない場合、既定のレベルは E (エラー)、W (警告)、および P (進行状況) になります。

すべてのイベントの先頭には、"YY/MM/DD HH:MM:SS" の形式のタイムスタンプが付きます。また使用可能な場合は、GUID または表示名も付加されます。

省略可能なパラメーターの event_guid_or_name には、ログ プロバイダーに関する例外のリストを指定します。この例外で指定されるイベントは、ログに記録されません。指定されないイベントがログに記録されます。

既定でログに記録されないイベントは、除外する必要はありません。

/SetpropertyPath;value

(省略可)。パッケージ内の変数、プロパティ、コンテナー、ログ プロバイダー、Foreach 列挙子、または接続の構成を上書きします。このオプションを指定すると、/Set は propertyPath 引数を、指定された値に変更します。複数の /Set オプションを指定できます。

パッケージ構成ウィザードを実行して、propertyPath の値を確認できます。最後の [ウィザードの完了] ページに選択したアイテムのパスが表示されるので、これをコピーして貼り付けることができます。この操作のみが目的でウィザードを使用した場合は、パスをコピーした後、ウィザードを取り消してください。

以下に、パッケージを実行し、変数に対して新しい値を指定する例を示します。

dtexec /f mypackage.dtsx /set \package.variables[myvariable].Value;myvalue

/Set オプションを使用すると、パッケージ構成を読み込む場所を変更することができますが、デザイン時の構成で指定した値を上書きすることはできません。パッケージ構成が適用されるしくみについては、「SSIS パッケージ構成」および「SQL Server 2008 R2 における Integration Services 機能の動作の変更」を参照してください。

/SQ[L]package_path

SQL Server に格納されているパッケージを読み込みます。package_path 引数には、取得するパッケージの名前を指定します。パス名を指定する場合、パス内のフォルダーの最後には円記号 ("\") を指定します。package_path 値は引用符で囲むことができます。package_path 引数に指定するパスまたはファイル名に空白文字を含める場合は、package_path 引数を引用符で囲む必要があります。

/User、/Password、および /Server オプションは、/SQL オプションと共に使用できます。

/User オプションを省略した場合、パッケージへのアクセスに Windows 認証が使用されます。/User オプションを使用する場合、指定する /User ログイン名は SQL Server 認証に関連付けられます。

/Password オプションは、/User オプションを指定した場合にのみ使用できます。/Password オプションを使用する場合、パッケージは指定されたユーザー名とパスワード情報を使用してアクセスされます。/Password オプションを省略した場合、空白のパスワードが使用されます。

セキュリティに関する注意

可能な場合は、Windows 認証を使用します。

/Server オプションを省略した場合、SQL Server の既定のローカル インスタンスが使用されます。

/SQL オプションは、/DTS または /File オプションと共に使用することはできません。複数のオプションが指定された場合、dtexec は失敗します。

/U[ser]user_name

(省略可)。SQL Server 認証によって保護されているパッケージの取得を可能にします。このオプションは、/SQL オプションが指定されている場合にのみ使用されます。user_name 値は引用符で囲むことができます。

セキュリティに関する注意

可能な場合は、Windows 認証を使用します。

/VerifyB[uild]major[;minor[;build]]

(省略可)。検証フェーズ中に、パッケージのビルド番号を、major、minor、および build 引数に指定されたビルド番号に対して検証します。不一致が発生した場合、パッケージは実行されません。

値は長整数型です。引数は次の 3 つの形式のいずれかになります。major の値は必須です。

• major

• major;minor

• major; minor; build

/VerifyS[igned]

(省略可)。Integration Services でパッケージのデジタル署名を確認します。パッケージが署名されていないか、署名が有効でない場合、パッケージは失敗します。詳細については、「パッケージでのデジタル署名の使用」を参照してください。

重要

パッケージの署名が確認されるように構成した場合、Integration Services によって確認されるのは、デジタル署名が存在するかどうか、有効かどうか、および信頼関係のある発行元の署名であるかどうかのみです。Integration Services では、パッケージが変更されたかどうかは確認されません。

注

オプションの BlockedSignatureStates レジストリ値では、Business Intelligence Development Studio または dtexec コマンド ラインで設定されたデジタル署名オプションよりも制限が厳しい設定を指定できます。この場合、制限が厳しい方のレジストリ設定が他の設定よりも優先されます。

/VLog[Filespec]

(省略可)。すべての Integration Services パッケージ イベントを、パッケージの設計時に有効にしたログ プロバイダーに書き込みます。Integration Services でテキスト ファイルのログ プロバイダーを有効にし、指定したテキスト ファイルにログ イベントを書き込むには、パスとファイル名を Filespec パラメーターとして含めます。

Filespec パラメーターを含めない場合、Integration Services でテキスト ファイルのログ プロバイダーが有効になりません。Integration Services では、パッケージの設計時に有効にしたログ プロバイダーに対してのみ、ログ イベントが書き込まれます。

/X86

(省略可)。SQL Server エージェントは 64 ビット コンピューター上で 32 ビット モードでパッケージを実行します。このオプションは、次に示す条件が満たされた場合に SQL Server エージェントによって設定されます。

• ジョブ ステップの種類が [SQL Server Integration Services パッケージ] であること。

• [新しいジョブ ステップ] ダイアログ ボックスの [実行オプション] タブで [32 ビット ランタイムを使用] オプションが選択されていること。

このオプションは、ストアド プロシージャまたは SQL Server 管理オブジェクト (SMO) を使用してジョブをプログラムにより作成することで、SQL Server エージェント ジョブ ステップに設定することもできます。 

このオプションは、SQL Server エージェントのみに使用されます。コマンド プロンプトで dtexec ユーティリティを実行している場合、このオプションは無視されます。