パッケージ実行ユーティリティ (dtexecui)

  • [アーティクル]

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

[パッケージ実行ユーティリティ] を使用すると、 Integration Services パッケージを実行できます。 このユーティリティは、Microsoft SQL Server データベース、SSIS パッケージ ストア、およびファイル システムの 3 つの場所のうちのいずれかに格納されているパッケージを実行できます。 このユーザー インターフェイスは、 SQL Server Management Studio DTExec コマンド プロンプト ツールを使用してパッケージを実行する代わりに使用できます。これは、 から開くか、またはコマンド プロンプトで「 dtexecui 」と入力して表示します。

dtexecui.exe ユーティリティと同じ手順でパッケージを実行します。 このユーティリティは 32 ビット ツールであるため、64 ビット環境では Windows on Win32 (WOW) で実行される 64 ビット環境の dtexecui.exe を使用して、パッケージを実行します。 64 ビット コンピューターで dtexecui.exe ユーティリティを使用してコマンドを開発およびテストする場合、実稼働サーバー上でコマンドの配置またはスケジュール設定を行う前に、64 ビット バージョンの dtexec.exe を使用してコマンドのテストを 64 ビット モードで行う必要があります。

パッケージ実行ユーティリティ は、 DTExec コマンド プロンプト ツールのグラフィカル ユーザー インターフェイスです。 このユーザー インターフェイスにより、オプションの構成が容易になります。指定したオプションでパッケージを実行すると、 DTExec コマンド プロンプト ツールに渡されるコマンド ラインが自動的に作成されます。

パッケージ実行ユーティリティ は、 DTExec を直接実行するときに使用するコマンド ラインの作成にも使用できます。

SQL Server Management Studio でパッケージ実行ユーティリティを開くには

  1. SQL Server Management Studioで、 [表示] メニューの [オブジェクト エクスプローラー]をクリックします。

  2. オブジェクト エクスプローラーで [接続]をクリックし、 [Integration Services]をクリックします。

  3. [サーバーへの接続] ダイアログ ボックスで、 [サーバー名] ボックスにサーバー名を入力し、 [接続]をクリックします。

  4. [格納されたパッケージ]フォルダーとサブフォルダーを展開し、実行するパッケージを右クリックして [パッケージの実行]をクリックします。

コマンド プロンプトでパッケージ実行ユーティリティを開くには

  • コマンド プロンプト ウィンドウで、 dtexecuiを実行します。

ここでは、 [パッケージ実行ユーティリティ] ダイアログ ボックスのページについて説明します。

[全般] ページ

[パッケージ実行ユーティリティ] ダイアログ ボックスの [全般] ページを使用すると、パッケージの名前と場所を指定できます。

パッケージがリモート サーバーに保存されている場合でも、パッケージ実行ユーティリティ (dtexecui.exe) は常にローカル コンピューターでパッケージを実行します。 リモート パッケージがリモート サーバーに保存されている構成ファイルを使用する場合は、パッケージ実行ユーティリティが構成を見つけられない可能性があり、この場合はパッケージは失敗します。 この問題を回避するには、\\myserver\myfile のような汎用名前付け規則 (UNC) 共有名を使用して、構成を参照するようにする必要があります。

静的オプション

[パッケージ ソース]
以下のオプションを使用して、パッケージを実行する場所を指定します。

値 説明
SQL Server パッケージが Microsoft SQL Server に存在する場合は、このオプションを選択します。 SQL Server のインスタンス、および SQL Server 認証に使用するユーザー名とパスワードを指定します。 各ユーザー名とパスワードによって、/USERユーザー名 および /PASSWORDパスワード オプションがコマンド プロンプトに追加されます。
ファイル システム パッケージがファイル システムに存在する場合は、このオプションを選択します。
[SSIS パッケージ ストア] パッケージが SSIS パッケージ ストアに存在する場合は、このオプションを選択します。

これらの各選択には以下のオプションのセットがあります。

実行
パッケージを実行します。

閉じる
[パッケージ実行ユーティリティ] ダイアログ ボックスを閉じます。

動的オプション

[パッケージ ソース] = [SQL Server]

[サーバー]
パッケージが存在する場所のサーバーの名前を入力するか、一覧からサーバーを選択します。

[サーバー ログオン]
パッケージが SQL Server に接続するために、Windows 認証と SQL Server認証のどちらを使用するかを指定します。 より高いセキュリティのためには Windows 認証をお勧めします。 Windows 認証ではユーザー名とパスワードを指定する必要はありません。

[Windows 認証を使用する]
Windows 認証と Microsoft Windows ユーザー アカウントを使用してログオンします。

[SQL Server 認証を使用する]
SQL Server 認証を使用します。 指定されたログイン名とパスワードを使用して、信頼関係の低い接続から接続した場合、 SQL Server は SQL Server ログイン アカウントが設定されているかどうか、指定されたパスワードが以前に記録されたパスワードと一致しているかどうかを確認することで認証を行います。 SQL Server のログイン アカウントが見つからない場合、認証は失敗し、エラー メッセージが返されます。

重要

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

パッケージ
パッケージ名を入力するか、参照ボタン ( [...] ) をクリックし [SSIS パッケージの選択] ダイアログ ボックスを使用してパッケージを検索します。

[パッケージ ソース] = [ファイル システム]

パッケージ
パッケージ名を入力するか、参照ボタン ( [...] ) をクリックし [開く] ダイアログ ボックスを使用してパッケージを検索します。 既定では、.dtsx 拡張子を持つファイルのみがダイアログ ボックスに一覧表示されます。

[パッケージ ソース] = [SSIS パッケージ ストア]

[サーバー]
パッケージが存在する場所のコンピューターの名前を入力するか、一覧からコンピューターを選択します。

[サーバー ログオン]
パッケージが Microsoft Windows 認証を使用して、パッケージ ソースに接続するかどうかを指定します。 より高いセキュリティのためには Windows 認証をお勧めします。 Windows 認証ではユーザー名とパスワードを指定する必要はありません。

[Windows 認証を使用する]
Windows 認証と Microsoft Windows ユーザー アカウントを使用してログオンします。

[SQL Server 認証を使用する]
[SSIS パッケージ ストア]に格納されているパッケージを実行する場合は、このオプションは使用できません。

パッケージ
パッケージ名を入力するか、参照ボタン ( [...] ) をクリックし [SSIS パッケージの選択] ダイアログ ボックスを使用してパッケージを検索します。

[構成] ページ

[パッケージ実行ユーティリティ] ダイアログ ボックスの [構成] ページを使用すると、実行時に読み込む構成ファイルの選択と、読み込む順序の指定ができます。

Options

構成ファイル
パッケージが使用する構成を一覧表示します。 構成ファイルごとに、 /CONFIGFILE filename オプションがコマンド プロンプトに追加されます。

方向キー
一覧で構成ファイルを選択し、右側にある方向キーを使用して読み込み順序を変更します。 構成は、一覧の一番上から順に読み込まれます。

Note

複数の構成によって同じプロパティが修正される場合、最後に読み込まれる構成が使用されます。

追加
[開く] ダイアログ ボックスを使用して、構成を追加します。 既定では、.dtsconfig 拡張子を持つファイルのみがダイアログ ボックスに一覧表示されます。

Remove
一覧で構成を選択し、次に [削除]をクリックします。

実行
パッケージを実行します。

閉じる
[パッケージ実行ユーティリティ] ダイアログ ボックスを閉じます。

[コマンド ファイル] ページ

[パッケージ実行ユーティリティ] ダイアログ ボックスの [コマンド ファイル] ページを使用すると、実行時に読み込むコマンド ファイルを選択できます。

Options

[コマンド ファイル]
パッケージが使用するコマンド ファイルを一覧表示します。 パッケージは、複数のファイルを使用してコマンド ライン オプションを設定できます。

方向キー
一覧でコマンド ファイルを選択し、右側にある方向キーを使用して読み込み順序を変更します。 コマンド ファイルは、一覧の一番上から順に読み込みます。

追加
[開く] ダイアログ ボックスを使用して、コマンド ファイルを追加します。

Remove
テキスト ボックスでコマンド ファイルを選択し、 [削除] ボタンを使用して削除します。

実行
パッケージを実行します。

閉じる
[パッケージ実行ユーティリティ] ダイアログ ボックスを閉じます。

[接続マネージャー] ページ

[パッケージ実行ユーティリティ] ダイアログ ボックスの [接続マネージャー] ページを使用すると、パッケージで使用する接続マネージャーの接続文字列を編集できます。

Options

接続マネージャー
チェック ボックスをオンにすると、 [接続文字列] 列が編集可能になります。

説明
それぞれの接続マネージャーの説明を表示します。 説明は編集できません。

接続文字列
接続マネージャーの接続文字列を編集します。 このフィールドは、 [接続マネージャー] チェック ボックスがオンの場合にのみ編集できます。

実行
パッケージを実行します。

閉じる
[パッケージ実行ユーティリティ] ダイアログ ボックスを閉じます。

[実行オプション] ページ

[パッケージ実行ユーティリティ] ダイアログ ボックスの [実行オプション] ページを使用すると、パッケージの実行時オプションを指定できます。

Options

[検証時に警告が発生したらパッケージを失敗とする]
検証時に警告が発生した場合に、パッケージを失敗させるかどうかを示します。

[パッケージを実行せずに検証する]
パッケージの検証のみを行うかどうかを示します。

[同時実行するファイルの最大数]
パッケージで同時に実行できる実行可能ファイルの最大数を指定するかどうかを示します。 このチェック ボックスをオンにして、スピン ボックスで実行可能ファイルの最大数を指定します。

[パッケージのチェックポイントを有効にする]
パッケージのチェックポイントを有効にするかどうかを示します。

[チェックポイント ファイル]
パッケージのチェックポイントが有効な場合、使用されるパッケージのチェックポイント ファイルを一覧表示します。

[参照]
パッケージのチェックポイントが有効な場合、参照ボタン ( [...] ) をクリックし、[開く] ダイアログ ボックスを使用してチェックポイント ファイルを探します。 チェックポイント ファイルが既に指定されている場合、選択したファイルで置き換えられます。

[再開オプションをオーバーライドする]
パッケージのチェックポイントが有効な場合、再開オプションをオーバーライドするかどうかを示します。

[再開オプション]
再開オプションをオーバーライドする場合、チェックポイントの使用方法を選択します。

実行
パッケージを実行します。

閉じる
[パッケージ実行ユーティリティ] ダイアログ ボックスを閉じます。

[レポート] ページ

[パッケージ実行ユーティリティ] ダイアログ ボックスの [レポート] ページを使用すると、パッケージを実行したときにコンソールのログに記録する、イベントとパッケージに関する情報を指定できます。

Options

[コンソールのイベント]
レポートに記録するイベントとメッセージの種類を指定します。

なし
レポートを作成しない場合に選択します。

エラー
エラー メッセージをレポートに記録する場合に選択します。

Warnings
警告メッセージをレポートに記録する場合に選択します。

[カスタム イベント]
カスタム イベントのメッセージをレポートに記録する場合に選択します。

[パイプライン イベント]
データ フロー イベントのメッセージをレポートに記録する場合に選択します。

情報
情報メッセージをレポートに記録する場合に選択します。

詳細
詳細レポートを使用する場合に選択します。

[コンソールのログ記録]
選択したイベントが発生したときにログに書き込まれる情報を指定します。

名前
パッケージを作成した人物の名前をレポートに記録する場合に選択します。

コンピューター
パッケージが実行されるコンピューターの名前をレポートに記録する場合に選択します。

[オペレーター]
パッケージを起動した人物の名前をレポートに記録する場合に選択します。

ソース名
パッケージの名前をレポートに記録する場合に選択します。

[ソース GUID]
パッケージの GUID をレポートに記録する場合に選択します。

[実行 GUID]
パッケージ実行インスタンスの GUID をレポートに記録する場合に選択します。

メッセージ
メッセージをレポートに記録する場合に選択します。

[開始時刻および終了時刻]
パッケージの開始時刻と終了時刻をレポートに記録する場合に選択します。

実行
パッケージを実行します。

閉じる
[パッケージ実行ユーティリティ] ダイアログ ボックスを閉じます。

[ログ記録] ページ

[パッケージ実行ユーティリティ] ダイアログ ボックスの [ログ記録] ページを使用すると、ログ プロバイダーの実行時にパッケージを利用できます。 パッケージのログ プロバイダーの種類とログに接続するための接続文字列を指定します。 ログ プロバイダーのエントリごとに、 /LOGGERclassid オプションがコマンド プロンプトに追加されます。

Options

[ログ プロバイダー]
一覧からログ プロバイダーを選択します。

[構成文字列]
ログの場所を指すパッケージから接続マネージャーの名前を選択するか、ログ プロバイダーに接続するための接続文字列を入力します。

Remove
ログ プロバイダーを選択し、クリックして削除します。

実行
パッケージを実行します。

閉じる
[パッケージ実行ユーティリティ] ダイアログ ボックスを閉じます。

[値の設定] ページ

[パッケージ実行ユーティリティ] ダイアログ ボックスの [値の設定] ページを使用すると、プロパティのパスと値を入力することにより、パッケージ、実行可能ファイル、接続、変数、およびログ プロバイダーのプロパティ値を設定できます。 パスのエントリごとに、コマンド プロンプトに /SETpropertypath;value オプションが追加されます。

Options

[プロパティのパス]
プロパティのパスを入力します。 パスの構文では、円記号 (\) を使用して続くアイテムがコンテナーであること示し、ピリオド (.) を使用して続くアイテムがプロパティであることを示します。また、角かっこはコレクションのメンバーを示します。 メンバーは、インデックスまたは名前で識別できます。 たとえば、パッケージ変数のプロパティのパスは、「\Package.Variables[MyVariable].Value」です。

Value
プロパティの値を入力します。

Remove
プロパティのパスを選択し、クリックして削除します。

実行
パッケージを実行します。

閉じる
[パッケージ実行ユーティリティ] ダイアログ ボックスを閉じます。

[検証] ページ

[パッケージ実行ユーティリティ] ダイアログ ボックスの [検証] ページを使用すると、パッケージを検証するための条件を設定できます。

Options

[署名付きパッケージのみ実行する]
署名されたパッケージのみ実行します。

[パッケージのビルドを検証する]
パッケージのビルドを検証します。

Build
ビルドに関連付けられた連続するビルド番号を指定します。

[パッケージ ID を確認する]
パッケージ ID を確認します。

[パッケージ ID]
パッケージの識別番号を指定します。

[バージョン ID を確認する]
バージョン ID を確認します。

バージョン ID
バージョンの識別番号を指定します。

実行
パッケージを実行します。

閉じる
[パッケージ実行ユーティリティ] ダイアログ ボックスを閉じます。

[コマンド ライン] ページ

[パッケージ実行ユーティリティ] ダイアログ ボックスの [コマンド ライン] ノードを使用すると、さまざまなダイアログ ボックスで作成されたオプションを使用して生成されたコマンド ラインを編集できます。

Options

[元のオプションを復元する]
コマンド ラインを元の状態に復元します。 [コマンド ラインを手動で編集する] オプションを使用して変更してから、元のコマンド ライン オプションを復元する場合は、このオプションを使用します。

[コマンド ラインを手動で編集する]
[コマンド ライン] テキスト ボックスのコマンド ラインを編集します。

コマンド ライン
現在のコマンド ラインを表示します。 コマンド ラインを手動で編集するためにこのオプションを選択した場合に編集可能です。

実行
パッケージを実行します。

閉じる
[パッケージ実行ユーティリティ] ダイアログ ボックスを閉じます。

関連項目

dtexec ユーティリティ