dtexec ユーティリティdtexec Utility

APPLIES TO: yesSQL Server, including on Linux yesAzure SQL Database yesAzure SQL Data Warehouse noParallel Data Warehouse

dtexec コマンド プロンプト ユーティリティは、 SQL ServerSQL Server Integration ServicesIntegration Services パッケージの構成と実行に使用します。The dtexec command prompt utility is used to configure and execute SQL ServerSQL Server Integration ServicesIntegration Services packages. dtexec ユーティリティを使用すると、パラメーター、接続、プロパティ、変数、ログ記録、進行状況インジケーターなど、パッケージの構成と実行に関するすべての機能にアクセスできます。The dtexec utility provides access to all the package configuration and execution features, such as parameters, connections, properties, variables, logging, and progress indicators. また dtexec ユーティリティでは、さまざまな変換元 ( Integration ServicesIntegration Services サーバー、.ispac プロジェクト ファイル、 MicrosoftMicrosoft SQL ServerSQL Server データベース、 SSISSSIS パッケージ ストア、およびファイル システム) からパッケージを読み込むことができます。The dtexec utility lets you load packages from these sources: the Integration ServicesIntegration Services server, an .ispac project file, a MicrosoftMicrosoft SQL ServerSQL Server database, the SSISSSIS Package Store, and the file system.

注: 最新バージョンの dtexec ユーティリティを使用して旧バージョンの Integration ServicesIntegration Servicesで作成したパッケージを実行すると、パッケージは一時的に最新のパッケージ形式にアップグレードされます。NOTE: When you use the current version of the dtexec utility to run a package created by an earlier version of Integration ServicesIntegration Services, the utility temporarily upgrades the package to the current package format. ただし、アップグレードされたパッケージを dtexec ユーティリティで保存することはできません。However, you cannot use the dtexec utility to save the upgraded package. パッケージを最新バージョンに永続的にアップグレードする方法については、「 Upgrade Integration Services Packages」を参照してください。For more information about how to permanently upgrade a package to the current version, see Upgrade Integration Services Packages.

このトピックのセクションは次のとおりです。This topic includes the following sections:

Integration Services サーバーとプロジェクト ファイルIntegration Services Server and Project File

dtexec を使用して Integration ServicesIntegration Services サーバーでパッケージを実行すると、dtexeccatalog.create_execution (SSISDB データベース)catalog.set_execution_parameter_value (SSISDB データベース)、および catalog.start_execution (SSISDB データベース) の各ストアド プロシジャを呼び出すことにより、実行を作成し、パラメーター値を設定して、実行を開始します。When you use dtexec to run packages on the Integration ServicesIntegration Services server, dtexec calls the catalog.create_execution (SSISDB Database), catalog.set_execution_parameter_value (SSISDB Database) and catalog.start_execution (SSISDB Database) stored procedures to create an execution, set parameter values and start the execution. すべての実行ログは、関連するビューでサーバーから確認できます。また、 SQL Server Management StudioSQL Server Management Studioで利用可能な標準レポートを使用して確認することもできます。All execution logs can be seen from the server in the related views or by using standard reports available in SQL Server Management StudioSQL Server Management Studio. レポートの詳細については、「 Integration Services サーバーのレポート」を参照してください。For more information about the reports, see Reports for the Integration Services Server.

Integration ServicesIntegration Services サーバーでのパッケージの実行例を次に示します。The following is an example of executing a package on the Integration ServicesIntegration Services server.

DTExec /ISSERVER "\SSISDB\folderB\Integration Services Project17\Package.dtsx" /SERVER "." /Envreference 2 /Par "$Project::ProjectParameter(Int32)";1 /Par "Parameter(Int32)";21 /Par "CM.sqlcldb2.SSIS_repro.InitialCatalog";ssisdb /Par "$ServerOption::SYNCHRONIZED(Boolean)";True  

dtexec を使用して .ispac プロジェクト ファイルからパッケージを実行する場合の関連オプションは、/Proj[ect] と /Pack[age] です。これらは、プロジェクトのパスとパッケージのストリーム名を指定するために使用されます。When you use dtexec to run a package from the .ispac project file, the related options are: /Proj[ect] and /Pack[age] that are used to specify the project path and package stream name. から Integration Services プロジェクト変換ウィザード SQL Server Management StudioSQL Server Management Studioを実行してプロジェクトをプロジェクト配置モデルに変換する場合、ウィザードは .ispac プロジェクト ファイルを生成します。When you convert a project to the project deployment model by running the Integration Services Project Conversion Wizard from SQL Server Management StudioSQL Server Management Studio, the wizard generates an .ispac projec file. 詳細については、「Integration Services (SSIS) プロジェクトとパッケージの配置」を参照してください。For more information, see Deploy Integration Services (SSIS) Projects and Packages.

dtexec とサードパーティのスケジューリング ツールを使用して、 Integration ServicesIntegration Services サーバーに配置されているパッケージのスケジュールを設定できます。You can use dtexec with third-party scheduling tools to schedule packages that are deployed to the Integration ServicesIntegration Services server.

64 ビット コンピューターでのインストールに関する注意点Installation Considerations on 64-bit Computers

64 ビット コンピューターには、 Integration ServicesIntegration Services によって 64 ビット版の dtexec ユーティリティ (dtexec.exe) がインストールされます。On a 64-bit computer, Integration ServicesIntegration Services installs a 64-bit version of the dtexec utility (dtexec.exe). 特定のパッケージを 32 ビット モードで実行する必要がある場合は、32 ビット版の dtexec ユーティリティをインストールする必要があります。If you have to run certain packages in 32-bit mode, you will have to install the 32-bit version of the dtexec utility. 32 ビット版の dtexec ユーティリティをインストールするには、セットアップ中に [クライアント ツール] または [ SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) ] を選択する必要があります。To install the 32-bit version of the dtexec utility, you must select either Client Tools or SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) during setup.

既定では、64 ビットと 32 ビットの両方のバージョンの Integration ServicesIntegration Services コマンド プロンプト ユーティリティがインストールされている 64 ビット コンピューターでは、コマンド プロンプトで 32 ビット バージョンが実行されます。By default, a 64-bit computer that has both the 64-bit and 32-bit versions of an Integration ServicesIntegration Services command prompt utility installed will run the 32-bit version at the command prompt. これは、PATH 環境変数で、32 ビット バージョンのディレクトリ パスが 64 ビット バージョンのディレクトリ パスより前に配置されているためですThe 32-bit version runs because the directory path for the 32-bit version appears in the PATH environment variable before the directory path for the 64-bit version. (通常、32 ビットのディレクトリ パスは <ドライブ> :\Program Files(x86)\Microsoft SQL Server\110\DTS\Binn で、64 ビットのディレクトリ パスは <ドライブ> :\Program Files\Microsoft SQL Server\110\DTS\Binn です)。(Typically, the 32-bit directory path is <drive>:\Program Files(x86)\Microsoft SQL Server\110\DTS\Binn, while the 64-bit directory path is <drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn.)

注: SQL Server エージェントを使用してユーティリティを実行する場合は、SQL Server エージェントによって 64 ビット バージョンのユーティリティが自動的に使用されます。NOTE: If you use SQL Server Agent to run the utility, SQL Server Agent automatically uses the 64-bit version of the utility. SQL Server エージェントでは、PATH 環境変数ではなくレジストリを使用してユーティリティの適切な実行可能ファイルが特定されます。SQL Server Agent uses the registry, not the PATH environment variable, to locate the correct executable for the utility.

コマンド プロンプトで 64 ビット バージョンのユーティリティが実行されるようにするには、次のいずれかの操作を実行します。To ensure that you run the 64-bit version of the utility at the command prompt, you can take one of the following actions:

  • コマンド プロンプト ウィンドウを開いて、64 ビット バージョンのユーティリティが格納されたディレクトリ ( <ドライブ> :\Program Files\Microsoft SQL Server\110\DTS\Binn) に移動し、その場所からユーティリティを実行します。Open a Command Prompt window, change to the directory that contains the 64-bit version of the utility (<drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn), and then run the utility from that location.

  • コマンド プロンプトで、64 ビット バージョンのユーティリティの完全なパス ( <ドライブ> :\Program Files\Microsoft SQL Server\110\DTS\Binn) を入力してユーティリティを実行します。At the command prompt, run the utility by entering the full path (<drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn) to the 64-bit version of the utility.

  • PATH 環境変数で、64 ビットのパス ( <ドライブ> :\Program Files\Microsoft SQL Server\110\DTS\Binn) を 32 ビットのパス ( <ドライブ> :\ Program Files(x86)\Microsoft SQL Server\110\DTS\Binn) より前に配置してパスの順序を永続的に変更します。Permanently change the order of the paths in the PATH environment variable by placing the 64-bit path (<drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn) before the 32-bit path (<drive>:\ Program Files(x86)\Microsoft SQL Server\110\DTS\Binn) in the variable.

サイド バイ サイド インストールを使用しているコンピューターに関する注意点Considerations on Computers with Side-by-Side Installations

SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) を、 SQL Server 2005 Integration Services (SSIS)SQL Server 2005 Integration Services (SSIS) または SQL Server 2008 Integration Services (SSIS)SQL Server 2008 Integration Services (SSIS) がインストールされているコンピューターにインストールすると、複数のバージョンの dtexec ユーティリティがインストールされます。When SQL Server 2017 Integration Services (SSIS)SQL Server 2017 Integration Services (SSIS) is installed on a machine that has SQL Server 2005 Integration Services (SSIS)SQL Server 2005 Integration Services (SSIS) or SQL Server 2008 Integration Services (SSIS)SQL Server 2008 Integration Services (SSIS) installed, multiple versions of the dtexec utility are installed.

正しいバージョンのユーティリティを実行していることを確認するには、コマンド プロンプトで完全なパス ( <ドライブ> :\Program Files\Microsoft SQL Server\<バージョン>\DTS\Binn) を入力してユーティリティを実行します。To ensure that you run the correct version of the utility, at the command prompt run the utility by entering the full path (<drive>:\Program Files\Microsoft SQL Server\<version>\DTS\Binn).

実行のフェーズPhases of Execution

このユーティリティの実行には、4 つのフェーズがあります。The utility has four phases that it proceeds through as it executes. それらのフェーズを次に示します。The phases are as follows:

  1. コマンド初期フェーズ:コマンド プロンプトによって、指定されたオプションおよび引数のリストが読み取られます。Command sourcing phase: The command prompt reads the list of options and arguments that have been specified. /? オプションAll subsequent phases are skipped if a /? または /HELP オプションが指定されている場合、後続のフェーズはすべてスキップされます。or /HELP option is encountered.

  2. パッケージ読み込みフェーズ: /SQL/FILE、または /DTS オプションによって指定されたパッケージが読み込まれます。Package load phase: The package specified by the /SQL, /FILE, or /DTS option is loaded.

  3. 構成フェーズ:オプションは次の順序で処理されます。Configuration phase: Options are processed in this order:

    • パッケージのフラグ、変数、およびプロパティを設定するオプションOptions that set package flags, variables, and properties.

    • パッケージのバージョン番号およびビルドを確認するオプションOptions that verify the package version and build.

    • レポートなど、ユーティリティの実行時の動作を構成するオプションOptions that configure the run-time behavior of the utility, such as reporting.

  4. 検証および実行フェーズ:パッケージを実行します。 /VALIDATE オプションが指定された場合は、実行せずに検証を実行します。Validation and execution phase: The package is run, or validated without running if the /VALIDATE option was specified.

返される終了コードExit Codes Returned

dtexec ユーティリティから返される終了コードExit codes returned from dtexec utility

パッケージの実行時、 dtexec は終了コードを返すことができます。When a package runs, dtexec can return an exit code. 終了コードは、ERRORLEVEL 変数の値を設定する場合に使用されます。この変数の値は、バッチ ファイル内の条件ステートメントや分岐ロジックでテストできます。The exit code is used to populate the ERRORLEVEL variable, the value of which can then be tested in conditional statements or branching logic within a batch file. 次の表は、終了時に dtexec ユーティリティが設定できる値を示しています。The following table lists the values that the dtexec utility can set when exiting.

ReplTest1Value DescriptionDescription
00 パッケージが正常に実行されました。The package executed successfully.
@shouldalert1 パッケージが失敗しました。The package failed.
33 パッケージはユーザーによって取り消されました。The package was canceled by the user.
44 ユーティリティは要求されたパッケージを見つけられません。The utility was unable to locate the requested package. パッケージが見つかりませんでした。The package could not be found.
55 ユーティリティは要求されたパッケージを読み込めません。The utility was unable to load the requested package. パッケージを読み込めませんでした。The package could not be loaded.
66 ユーティリティは、コマンド ラインに構文の内部エラーまたはセマンティック エラーを検出しました。The utility encountered an internal error of syntactic or semantic errors in the command line.

構文規則Syntax Rules

ユーティリティの構文規則Utility syntax rules

すべてのオプションは、スラッシュ (/) またはマイナス記号 (-) で始まる必要があります。All options must start with a slash (/) or a minus sign (-). ここに示すオプションはスラッシュ (/) で始まりますが、マイナス記号 (-) を代わりに使用することもできます。The options that are shown here start with a slash (/), but the minus sign (-) can be substituted.

引数に空白文字を含めるには、引用符で囲む必要があります。An argument must be enclosed in quotation marks if it contains a space. 引数を引用符で囲まないと、空白文字を引数に含めることはできません。If the argument is not enclosed in quotation marks, the argument cannot contain white space.

引用符で囲まれた文字列内に二重引用符がある場合は、単一引用符がエスケープされていることを表します。Doubled quotation marks within quoted strings represent escaped single quotation marks.

パスワードを除いて、オプションおよび引数では大文字と小文字が区別されません。Options and arguments are not case-sensitive, except for passwords.

xp_cmdshell での dtexec の使用Using dtexec from the xp_cmdshell

xp_cmdshell での dtexec の使用Using dtexec from the xp_cmdshell

xp_cmdshell プロンプトから dtexec を実行できます。You can run dtexec from the xp_cmdshell prompt. 次の例では、UpsertData.dtsx というパッケージを実行し、リターン コードを無視します。The following example shows how to run a package called UpsertData.dtsx and ignore the return code:

EXEC xp_cmdshell 'dtexec /f "C:\UpsertData.dtsx"'  

次の例では、同じパッケージを実行し、リターン コードを取得します。The following example shows how to run the same package and capture the return code:

DECLARE @returncode int  
EXEC @returncode = xp_cmdshell 'dtexec /f "C:\UpsertData.dtsx"'  

重要!!IMPORTANT!! MicrosoftMicrosoftSQL ServerSQL Serverを新しくインストールした場合、 xp_cmdshell オプションは既定により無効になっています。In MicrosoftMicrosoftSQL ServerSQL Server, the xp_cmdshell option is disabled by default on new installations. オプションを有効にするには、 sp_configure システム ストアド プロシージャを実行します。The option can be enabled by running the sp_configure system stored procedure. 詳細については、「 xp_cmdshell サーバー構成オプション」を参照してください。For more information, see xp_cmdshell Server Configuration Option.

Bash からの dtexec の使用Using dtexec from Bash

Bash シェルは、Linux では一般的なシェルです。The Bash shell is a popular shell for Linux. Windows でも使用できます。It can also be used on Windows. Bash プロンプトから dtexec を実行できます。You can run dtexec from the Bash prompt. Bash ではセミコロン (;) がコマンド区切り演算子となることに注意してください。Notice that a semicolon (;) is a command delimiter operator in Bash. これは特に、/Conn[ection]/Par[arameter] または '/Set オプションを使用してパッケージに値を渡すときに重要です。セミコロンを使用して、名前と、指定された項目の値を区切るためです。This is particularly important when passing in values to the package using the /Conn[ection] or /Par[arameter] or '/Set options since they use the semicolon to separate the name and the value of the item provided. 次の例では、Bash を使って値をパッケージに渡すときに、セミコロンとその他の項目を正しくエスケープする方法を示します。The following example shows how to properly escape the semicolon and other items when using Bash and passing in values to a package:

dtexec /F MyPackage.dtsx /CONN "MyConnection"\;"\"MyConnectionString\""

構文Syntax

dtexec /option [value] [/option [value]]...  

パラメーターParameters

  • /?/? [option_name]:(省略可)。 コマンド プロンプトのオプション、または指定された option_name のヘルプを表示して、ユーティリティを終了します。Displays the command prompt options, or displays help for the specified option_name and then closes the utility.

    option_name 引数を指定すると、 dtexec によって SQL ServerSQL Server オンライン ブックが起動され、「dtexec ユーティリティ」トピックが表示されます。If you specify an option_name argument, dtexec starts SQL ServerSQL Server Books Online and displays the dtexec Utility topic.

  • /Ca[llerInfo] :(省略可)。/Ca[llerInfo]: (Optional). パッケージ実行の追加情報を指定します。Specifies additional information for a package execution. SQL Server エージェントを使用してパッケージを実行する場合、エージェントはこの引数を設定して、パッケージ実行が SQL Server エージェントによって呼び出されることを示します。When you run a package using SQL Server Agent, agent sets this argument to indicate that the package execution is invoked by SQL Server Agent. dtexec ユーティリティがコマンド ラインから実行される場合、このパラメーターは無視されます。This parameter is ignored when the dtexec utility is run from the command line.

  • /CheckF[ile] filespec:(省略可)。/CheckF[ile] filespec: (Optional). パッケージの CheckpointFileName プロパティが、 filespecで指定されたパスおよびファイルに設定されます。Sets the CheckpointFileName property on the package to the path and file spemandcified in filespec. このファイルは、パッケージが再起動されたときに使用されます。This file is used when the package restarts. このオプションが指定されていて、ファイル名の値が指定されていない場合、パッケージの CheckpointFileName には空の文字列が設定されます。If this option is specified and no value is supplied for the file name, the CheckpointFileName for the package is set to an empty string. このオプションが指定されない場合、パッケージの値は保持されます。If this option is not specified, the values in the package are retained.

  • /CheckP[ointing] {on\off} :(省略可)。/CheckP[ointing] {on\off} : (Optional). パッケージの実行時にパッケージがチェックポイントを使用するかどうかを決定する値を設定します。Sets a value that determines whether the package will use checkpoints during package execution. on を指定すると、失敗したパッケージが再実行されます。The value on specifies that a failed package is to be rerun. 失敗したパッケージが再実行される場合、ランタイム エンジンは、障害点からパッケージを再起動するためにチェックポイント ファイルを使用します。When the failed package is rerun, the run-time engine uses the checkpoint file to restart the package from the point of failure.

    オプションが値なしで宣言されている場合、既定値は on です。The default value is on if the option is declared without a value. 値が on に設定されていて、チェックポイント ファイルが見つからない場合、パッケージの実行は失敗します。Package execution will fail if the value is set to on and the checkpoint file cannot be found. このオプションが指定されない場合、パッケージの値セットは保持されます。If this option is not specified, the value set in the package is retained. 詳細については、「 Restart Packages by Using Checkpoints」を参照してください。For more information, see Restart Packages by Using Checkpoints.

    dtexec の /CheckPointing on オプションを使用すると、パッケージの SaveCheckpoints プロパティを True に設定した場合、および CheckpointUsage プロパティを Always に設定した場合と同等の効果が得られます。The /CheckPointing on option of dtexec is equivalent to setting the SaveCheckpoints property of the package to True, and the CheckpointUsage property to Always.

  • /Com[mandFile] filespec:(省略可)。/Com[mandFile] filespec: (Optional). dtexecで実行するコマンド オプションを指定します。Specifies the command options that run with dtexec. filespec で指定されたファイルが開き、ファイルに EOF が見つかるまでそのファイルからオプションを読み取ります。The file specified in filespec is opened and options from the file are read until EOF is found in the file. filespec は、テキスト ファイルです。filespec is a text file. filespec 引数には、パッケージの実行に関連付けるコマンド ファイルのファイル名とパスを指定します。The filespec argument specifies the file name and path of the command file to associate with the execution of the package.

  • /Conf[igFile] filespec:(省略可)。/Conf[igFile] filespec: (Optional). 値を抽出する構成ファイルを指定します。Specifies a configuration file to extract values from. このオプションを使用すると、パッケージのデザイン時に指定された構成と異なる実行時構成を設定できます。Using this option, you can set a run-time configuration that differs from the configuration that was specified at design time for the package. パッケージを実行するには、XML 構成ファイルに異なる構成設定を格納してから、 /ConfigFile オプションを使用して設定を読み込む必要があります。You can store different configuration settings in an XML configuration file and then load the settings before package execution by using the /ConfigFile option.

    /ConfigFile オプションを使用すると、デザイン時に指定しなかった追加の構成を実行時に読み込むことができますが、You can use the /ConfigFile option to load additional configurations at run time that you did not specify at design time. /ConfigFile オプションを使用しても、デザイン時に指定した構成値を置き換えることはできません。However, you cannot use the /ConfigFile option to replace configured values that you also specified at design time. パッケージ構成が適用されるしくみについては、「 Package Configurations」を参照してください。To understand how package configurations are applied, see Package Configurations.

  • /Conn[ection] id_or_name;connection_string [[;id_or_name;connection_string]...] :(省略可)。/Conn[ection] id_or_name;connection_string [[;id_or_name;connection_string]...]: (Optional). 指定した名前または GUID の接続マネージャーがパッケージ内にあり、接続文字列が指定されていることを示します。Specifies that the connection manager with the specified name or GUID is located in the package, and specifies a connection string.

    このオプションでは、接続マネージャーの名前または GUID を指定する id_or_name 引数と、有効な接続文字列を指定する connection_string 引数の両方のパラメーターが必須です。This option requires that both parameters be specified: the connection manager name or GUID must be provided in the id_or_name argument, and a valid connection string must be specified in the connection_string argument. 詳細については、「Integration Services (SSIS) の接続」を参照してください。For more information, see Integration Services (SSIS) Connections.

    実行時に /Connection オプションを使用すると、デザイン時に指定した場所とは別の場所からパッケージ構成を読み込むことができます。At run time, you can use the /Connection option to load package configurations from a location other than the location that you specified at design time. デザイン時に指定した値は、それらの構成の値で置き換えられます。The values of these configurations then replace the values that were originally specified. ただし、 /Connection オプションを使用できるのは、接続マネージャーを使用する構成 ( SQL ServerSQL Server 構成など) だけです。However you can use the /Connection option only for configurations, such as SQL ServerSQL Server configurations, that use a connection manager. パッケージ構成が適用されるしくみについては、「 Package Configurations 」 (パッケージ構成) および「 SQL Server 2016 における Integration Services 機能の動作の変更」を参照してください。To understand how package configurations are applied, see Package Configurations and Behavior Changes to Integration Services Features in SQL Server 2016.

  • /Cons[oleLog] [[displayoptions];[list_options;src_name_or_guid]...]:(省略可)。/Cons[oleLog] [[displayoptions];[list_options;src_name_or_guid]...]: (Optional). パッケージの実行中に、指定されたログ エントリをコンソールに表示します。Displays specified log entries to the console during package execution. このオプションを省略した場合、ログ エントリはコンソールに表示されません。If this option is omitted, no log entries are shown in the console. 表示を制限するパラメーターなしでオプションが指定された場合、すべてのログ エントリが表示されます。If the option is specified without parameters that limit the display, every log entry will display. コンソールに表示されるエントリを制限するには、 displayoptions パラメーターを使用して表示する列を指定し、 list_options パラメーターを使用してログ エントリの種類を制限します。To limit the entries that are displayed to the console, you can specify the columns to show by using the displayoptions parameter, and limit the log entry types by using the list_options parameter.

    注: Integration ServicesIntegration Services サーバーで /ISSERVER パラメーターを使用してパッケージを実行すると、コンソールの出力が制限され、 /Cons[oleLog] オプションのほとんどが適用されなくなります。NOTE: When you run a package on the Integration ServicesIntegration Services server by using the /ISSERVER parameter, console output is limited and most of the /Cons[oleLog] options are not applicable. すべての実行ログは、関連するビューでサーバーから確認できます。また、 SQL Server Management StudioSQL Server Management Studioで利用可能な標準レポートを使用して確認することもできます。All execution logs can be seen from the server in the related views or by using standard reports available in SQL Server Management StudioSQL Server Management Studio. レポートの詳細については、「 Integration Services サーバーのレポート」を参照してください。For more information about the reports, see Reports for the Integration Services Server.

    displayoptions の値は次のとおりです。The displayoptions values are as follows:

    • N (名前)N (Name)

    • C (コンピューター)C (Computer)

    • O (オペレーター)O (Operator)

    • S (変換元の名前)S (Source Name)

    • G (変換元の GUID)G (Source GUID)

    • X (実行 GUID)X (Execution GUID)

    • M (メッセージ)M (Message)

    • T (開始時刻および終了時刻)T (Time Start and End)

    list_options の値は次のとおりです。The list_options values are as follows:

    • I - 包含一覧を指定します。I - Specifies the inclusion list. 指定された変換元の名または変換元の GUID のみがログに記録されます。Only the source names or GUIDs that are specified are logged.

    • E - 除外一覧を指定します。E - Specifies the exclusion list. 指定された変換元の名前または変換元の GUID はログに記録されません。The source names or GUIDs that are specified are not logged.

    • src_name_or_guid パラメーターには、含めるまたは除外するイベント名、変換元の名前、変換元の GUID を指定します。The src_name_or_guid parameter specified for inclusion or exclusion is an event name, source name, or source GUID.

    同じコマンド プロンプトで複数の /ConsoleLog オプションを使用する場合、次のような相互作用があります。If you use multiple /ConsoleLog options on the same command prompt, they interact as follows:

    • 表示の順序には影響しません。Their order of appearance has no effect.

    • 包含一覧がコマンド ラインに指定されていない場合、すべての種類のログ エントリに対して除外一覧が適用されます。If no inclusion lists are present on the command line, exclusion lists are applied against all kinds of log entries.

    • 包含一覧がコマンド ラインに指定されている場合、すべての包含一覧の集合に対して除外一覧が適用されます。If any inclusion lists are present on the command line, exclusion lists are applied against the union of all inclusion lists.

    /ConsoleLog オプションの例については、「 解説 」を参照してください。For several examples of the /ConsoleLog option, see the Remarks section.

  • /D[ts] package_path:(省略可)。/D[ts] package_path: (Optional). SSIS パッケージ ストアからパッケージを読み込みます。Loads a package from the SSIS Package Store. SSIS パッケージ ストアに格納されているパッケージは、従来のパッケージ配置モデルを使用して配置されます。Packages that are stored in the SSIS Package Store, are deployed using the legacy package deployment model. プロジェクト配置モデルを使用して、Integration ServicesIntegration Services サーバーに配置されているパッケージを実行するには、 /ISServer オプションを使用します。To run packages that are deployed to the Integration ServicesIntegration Services server using the project deployment model, use the /ISServer option. パッケージとプロジェクトの配置モデルの詳細については、「 Deployment of Projects and Packages」を参照してください。For more information about the package and project deployment models, see Deployment of Projects and Packages.

    package_path 引数には、 SSISSSIS パッケージの相対パスを指定します。このパスは SSIS パッケージ ストアのルートから始まり、 SSISSSIS パッケージの名前を含むパスです。The package_path argument specifies the relative path of the SSISSSIS package, starting at the root of the SSIS Package Store, and includes the name of the SSISSSIS package. package_path 引数に指定するパスまたはファイル名に空白文字を含める場合は、 package_path 引数を引用符で囲む必要があります。If the path or file name specified in the package_path argument contains a space, you must put quotation marks around the package_path argument.

    /DTS オプションは、 /File オプションまたは /SQL オプションと同時に使用できません。The /DTS option cannot be used together with the /File or /SQL option. 複数のオプションが指定された場合、 dtexec は失敗します。If multiple options are specified, dtexec fails.

  • /De[crypt] password:(省略可)。/De[crypt] password: (Optional). パスワードが暗号化されているパッケージを読み込むときに使用する暗号化解除用パスワードを設定します。Sets the decryption password that is used when you load a package with password encryption.

  • (省略可)。パッケージの実行中に指定のイベントが 1 つ以上発生した場合に、デバッグ ダンプ ファイル (.mdmp および .tmp) を作成します。(Optional) Creates the debug dump files, .mdmp and .tmp, when one or more specified events occur while the package is running. error code 引数では、システムによるデバッグ ダンプ ファイル作成のトリガーとなるイベント コードの種類 (エラー、警告、または情報) が指定されます。The error code argument specifies the type of event code-error, warning, or information-that will trigger the system to create the debug dump files. イベント コードを複数指定するには、各 error code 引数をセミコロン (;) で区切ります。To specify multiple event codes, separate each error code argument by a semi-colon (;). error code 引数に引用符を含めないでください。Do not include quotes with the error code argument.

    次の例では、DTS_E_CANNOTACQUIRECONNECTIONFROMCONNECTIONMANAGER のエラーが発生したときにデバッグ ダンプ ファイルが生成されます。The following example generates the debug dump files when the DTS_E_CANNOTACQUIRECONNECTIONFROMCONNECTIONMANAGER error occurs.

    /Dump 0xC020801C  
    

    /Dump error code:Integration ServicesIntegration Services の既定では、デバッグ ダンプ ファイルは <ドライブ>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps フォルダーに格納されます。/Dump error code: By default, Integration ServicesIntegration Services stores the debug dump files in the folder, <drive>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps.

    注: デバッグ ダンプ ファイルには機密情報が含まれている場合があります。NOTE: Debug dump files may contain sensitive information. アクセス制御リスト (ACL) を使用してファイルへのアクセスを制限するか、アクセスが制限されたフォルダーにファイルをコピーしてください。Use an access control list (ACL) to restrict access to the files, or copy the files to a folder with restricted access. たとえば、デバッグ ファイルを Microsoft サポート サービスに送信する前には、機密性の高い情報をすべて削除することをお勧めします。For example, before you send your debug files to Microsoft support services, we recommended that you remove any sensitive or confidential information.

    dtexec ユーティリティで実行するすべてのパッケージにこのオプションを適用するには、 DumpOnCodes REG_SZ 値をレジストリ キー HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath に追加します。To apply this option to all packages that the dtexec utility runs, add a DumpOnCodes REG_SZ value to the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath registry key. DumpOnCodes のデータ値では、システムによるデバッグ ダンプ ファイル作成のトリガーとなるエラー コードを指定します。The data value in DumpOnCodes specifies the error code or codes that will trigger the system to create debug dump files. 複数のエラー コードは、セミコロン (;) で区切る必要があります。Multiple error codes must be separated by a semi-colon (;).

    DumpOnCodes 値をレジストリ キーに追加し、 /Dump オプションも使用した場合、両方の設定に基づくデバッグ ダンプ ファイルが作成されます。If you add a DumpOnCodes value to the registry key, and use the /Dump option, the system will create debug dump files that are based on both settings.

    デバッグ ダンプ ファイルの詳細については、「 Generating Dump Files for Package Execution」を参照してください。For more information about debug dump files, see Generating Dump Files for Package Execution.

  • /DumpOnError:(省略可) パッケージの実行中にエラーが発生した場合に、デバッグ ダンプ ファイル (.mdmp および .tmp) を作成します。/DumpOnError: (Optional) Creates the debug dump files, .mdmp and .tmp, when any error occurs while the package is running.

    Integration ServicesIntegration Services の既定では、デバッグ ダンプ ファイルは <ドライブ> :\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps フォルダーに格納されます。By default, Integration ServicesIntegration Services stores the debug dump files in the folder, <drive>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps folder.

    注: デバッグ ダンプ ファイルには機密情報が含まれている場合があります。NOTE: Debug dump files may contain sensitive information. アクセス制御リスト (ACL) を使用してファイルへのアクセスを制限するか、アクセスが制限されたフォルダーにファイルをコピーしてください。Use an access control list (ACL) to restrict access to the files, or copy the files to a folder with restricted access. たとえば、デバッグ ファイルを Microsoft サポート サービスに送信する前には、機密性の高い情報をすべて削除することをお勧めします。For example, before you send your debug files to Microsoft support services, we recommended that you remove any sensitive or confidential information.

    dtexec ユーティリティで実行するすべてのパッケージにこのオプションを適用するには、 DumpOnError REG_DWORD 値をレジストリ キー HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath に追加します。To apply this option to all packages that the dtexec utility runs, add a DumpOnError REG_DWORD value to the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath registry key. DumpOnError REG_DWORD の値によって、 dtexec ユーティリティで /DumpOnError オプションを使用する必要があるかどうかが決まります。The value of the DumpOnError REG_DWORD value determines whether the /DumpOnError option needs to be used with the dtexec utility:

    • ゼロ以外のデータ値を指定すると、 dtexec ユーティリティで /DumpOnError オプションを使用するかどうかにかかわらず、エラーの発生時にデバッグ ダンプ ファイルが作成されます。A non-zero data value indicates that the system will create debug dump files when any error occurs, regardless of whether you use the /DumpOnError option with the dtexec utility.

    • ゼロのデータ値を指定すると、 DumpOnError ユーティリティで dtexec ユーティリティをインストールする必要があります。A zero data value indicates that the system will not create the debug dump files unless you use the /DumpOnError option with the dtexec utility.

    デバッグ ダンプ ファイルの詳細については、「 Generating Dump Files for Package Execution」を参照してください。For more information about debug dump files, see Generating Dump Files for Package Execution

  • /Env[Reference] environment reference ID:(省略可)。/Env[Reference] environment reference ID: (Optional). Integration ServicesIntegration Services サーバーに配置するパッケージ用に、パッケージ実行で使用される環境参照 (ID) を指定します。Specifies the environment reference (ID) that is used by the package execution, for a package that is deployed to the Integration ServicesIntegration Services server. このパラメーターを変数にバインドするように構成すると、環境に含まれる変数の値が使用されます。The parameters configured to bind to variables will use the values of the variables that are contained in the environment.

    /Env[Reference] オプションは、 /ISServer オプションおよび /Server オプションと共に使用します。You use /Env[Reference] option together with the /ISServer and the /Server options.

    このパラメーターは SQL Server エージェントによって使用されます。This parameter is used by SQL Server Agent.
    -- /F[ile] filespec:(省略可)。-- /F[ile] filespec: (Optional). ファイル システムに保存されているパッケージを読み込みます。Loads a package that is saved in the file system. ファイル システムに保存されているパッケージは、従来のパッケージ配置モデルを使用して配置されます。Packages that are saved in the file system, are deployed using the legacy package deployment model. プロジェクト配置モデルを使用して、 Integration ServicesIntegration Services サーバーに配置されているパッケージを実行するには、 /ISServer オプションを使用します。To run packages that are deployed to the Integration ServicesIntegration Services server using the project deployment model, use the /ISServer option. パッケージとプロジェクトの配置モデルの詳細については、「 Deployment of Projects and Packages」を参照してください。For more information about the package and project deployment models, see Deployment of Projects and Packages

filespec 引数には、パッケージのパスとファイル名を指定します。The filespec argument specifies the path and file name of the package. 汎用名前付け規則 (UNC) 形式のパス、またはローカル パスのどちらかでパスを指定できます。You can specify the path as either a Universal Naming Convention (UNC) path or a local path. filespec 引数に指定するパスまたはファイル名に空白文字を含める場合は、 filespec 引数を引用符で囲む必要があります。If the path or file name specified in the filespec argument contains a space, you must put quotation marks around the filespec argument.

 <span data-ttu-id="4c71e-324">**/File** オプションは、 **/DTS** オプションまたは **/SQL** オプションと同時に使用できません。</span><span class="sxs-lookup"><span data-stu-id="4c71e-324">The **/File** option cannot be used together with the **/DTS** or **/SQL** option.</span></span> <span data-ttu-id="4c71e-325">複数のオプションが指定された場合、 **dtexec** は失敗します。</span><span class="sxs-lookup"><span data-stu-id="4c71e-325">If multiple options are specified, **dtexec** fails.</span></span>  
  • /H[elp] [option_name]:(省略可)。/H[elp] [option_name]: (Optional). オプションのヘルプ、または指定された option_name のヘルプを表示して、ユーティリティを終了します。Displays help for the options, or displays help for the specified option_name and closes the utility.

    option_name 引数を指定すると、 dtexec によって SQL ServerSQL Server オンライン ブックが起動され、「dtexec ユーティリティ」トピックが表示されます。If you specify an option_name argument, dtexec starts SQL ServerSQL Server Books Online and displays the dtexec Utility topic.

  • /ISServer packagepath:(省略可)。/ISServer packagepath: (Optional). Integration ServicesIntegration Services サーバーに配置するパッケージを実行します。Runs a package that is deployed to the Integration ServicesIntegration Services server. PackagePath 引数には、 Integration ServicesIntegration Services サーバーに配置するパッケージの完全なパスとファイル名を指定します。The PackagePath argument specifies the full path and file name of the package deployed to the Integration ServicesIntegration Services server. PackagePath 引数に指定するパスまたはファイル名に空白文字を含める場合は、 PackagePath 引数を引用符で囲む必要があります。If the path or file name specified in the PackagePath argument contains a space, you must put quotation marks around the PackagePath argument.

    パッケージ形式は次のとおりです。The package format is as follows:

    \<catalog name>\<folder name>\<project name>\package file name  
    

    /Server オプションは、 /ISSERVER オプションと共に使用します。You use /Server option together with the /ISSERVER option. SSIS サーバーでパッケージを実行できるのは Windows 認証のみです。Only Windows Authentication can execute a package on the SSIS Server. 現在の Windows ユーザーはパッケージへのアクセスに使用されます。The current Windows user is used to access the package. /Server オプションを省略した場合、 SQL ServerSQL Server の既定のローカル インスタンスが使用されます。If the /Server option is omitted, the default local instance of SQL ServerSQL Server is assumed.

    /ISSERVER オプションは、 /DTS/SQL 、または /File オプションと同時には使用できません。The /ISSERVER option cannot be used together with the /DTS, /SQL or /File option. 複数のオプションが指定された場合、dtexec は失敗します。If multiple options are specified, dtexec fails.

    このパラメーターは SQL Server エージェントによって使用されます。This parameter is used by SQL Server Agent.

  • /L[ogger] classid_orprogid;configstring:(省略可)。/L[ogger] classid_orprogid;configstring: (Optional). 1 つまたは複数のログ プロバイダーを SSISSSIS パッケージの実行と関連付けます。Associates one or more log providers with the execution of an SSISSSIS package. classid_orprogid パラメーターには、ログ プロバイダーを指定します。指定できるのはクラス GUID です。The classid_orprogid parameter specifies the log provider, and can be specified as a class GUID. configstring は、ログ プロバイダーを構成するために使用する文字列です。The configstring is the string that is used to configure the log provider.

    使用できるログ プロバイダーは次のとおりです。The following list shows the available log providers:

    • テキスト ファイル:Text file:

      • ProgID:DTS.LogProviderTextFile.1ProgID: DTS.LogProviderTextFile.1

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

    • SQL Server プロファイラーSQL Server Profiler::

      • ProgID:DTS.LogProviderSQLProfiler.1ProgID: DTS.LogProviderSQLProfiler.1

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

    • SQL ServerSQL Server::

      • ProgID:DTS.LogProviderSQLServer.1ProgID: DTS.LogProviderSQLServer.1

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

    • Windows イベント ログ:Windows Event Log:

      • ProgID:DTS.LogProviderEventLog.1ProgID: DTS.LogProviderEventLog.1

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

    • XML ファイル:XML File:

      • ProgID:DTS.LogProviderXMLFile.1ProgID: DTS.LogProviderXMLFile.1

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

  • /M[axConcurrent] concurrent_executables:(省略可)。/M[axConcurrent] concurrent_executables: (Optional). パッケージが同時に実行できる実行可能ファイルの数を指定します。Specifies the number of executable files that the package can run concurrently. 負以外の整数または -1 を指定する必要があります。The value specified must be either a non-negative integer, or -1. 値 -1 は、 SSISSSIS が同時に実行できる実行可能ファイルの最大数が、パッケージを実行するコンピューターのプロセッサの合計数に 2 を加えたものと等しいことを意味します。A value of -1 means that SSISSSIS will allow a maximum number of concurrently running executables that is equal to the total number of processors on the computer executing the package, plus two.

  • /Pack[age] PackageName:(省略可)。/Pack[age] PackageName: (Optional). 実行されるパッケージを指定します。Specifies the package that is executed. このパラメーターは、 Visual StudioVisual Studioからパッケージを実行する場合に主に使用されます。This parameter is used primarily when you execute the package from Visual StudioVisual Studio.

  • /P[assword] password:(省略可)。/P[assword] password: (Optional). SQL ServerSQL Server 認証によって保護されているパッケージの取得を可能にします。Allows the retrieval of a package that is protected by SQL ServerSQL Server Authentication. このオプションは、 /User オプションと共に使用します。This option is used together with the /User option. /Password オプションを省略して /User オプションを使用する場合、空白のパスワードが使用されます。If the /Password option is omitted and the /User option is used, a blank password is used. password 値は引用符で囲むことができます。The password value may be quoted.

    重要!!IMPORTANT!! 可能な場合は、Windows 認証を使用します。When possible, use Windows authentication.

  • /Par[ameter] [$Package:: | $Project:: | $ServerOption::] parameter_name [(data_type)]; literal_value:(省略可)。/Par[ameter] [$Package:: | $Project:: | $ServerOption::] parameter_name [(data_type)]; literal_value: (Optional). パラメーター値を指定します。Specifies parameter values. 複数の /Parameter オプションを指定できます。Multiple /Parameter options can be specified. データ型は、文字列としての CLR TypeCodes です。The data types are CLR TypeCodes as strings. 文字列型でないパラメーターの場合、データ型をかっこで囲んで指定してから、続けてパラメーター名を指定します。For a non-string parameter, the data type is specified in parenthesis, following the parameter name.

    /Parameter オプションは、 /ISServer オプションと共に使用する必要があります。The /Parameter option can be used only with the /ISServer option.

    パッケージ パラメーター、プロジェクト パラメーター、およびサーバー オプション パラメーターを示すには、$Package、$Project、$ServerOption の各プレフィックスをそれぞれ使用します。You use the $Package, $Project, and $ServerOption prefixes to indicate a package parameter, project parameter, and a server option parameter, respectively. 既定のパラメーターの型はパッケージです。The default parameter type is package.

    パッケージを実行して、プロジェクト パラメーター (myparam) に myvalue を指定し、パッケージ パラメーター (anotherparam) に整数値 12 を指定する例を次に示します。The following is an example of executing a package and providing myvalue for the project parameter (myparam) and the integer value 12 for the package parameter (anotherparam).

    Dtexec /isserver "SSISDB\MyFolder\MyProject\MyPackage.dtsx" /server "." /parameter $Project::myparam;myvalue /parameter anotherparam(int32);12

    パラメーターを使用して、接続マネージャーのプロパティを設定することもできます。You can also set connection manager properties by using parameters. 接続マネージャーのパラメーターであることを示すには、CM プレフィックスを使用します。You use the CM prefix to denote a connection manager parameter.

    次の例では、SourceServer 接続マネージャーの InitialCatalog プロパティが ssisdbに設定されています。In the following example, InitialCatalog property of the SourceServer connection manager is set to ssisdb.

    /parameter CM.SourceServer.InitialCatalog;ssisdb  
    

    次の例では、SourceServer 接続マネージャーの ServerName プロパティが、ローカル サーバーを示すためにピリオド (.) に設定されています。In the following example, ServerName property of the SourceServer connection manager is set to a period (.) to indicate the local server.

    /parameter CM.SourceServer.ServerName;.  
    
  • /Proj[ect] ProjectFile:(省略可)。/Proj[ect] ProjectFile: (Optional). 実行されるパッケージの取得元となるプロジェクトを指定します。Specifies the project from which to retrieve the package that is executed. ProjectFile 引数には、.ispac ファイル名を指定します。The ProjectFile argument specifies the .ispac file name. このパラメーターは、 Visual StudioVisual Studioからパッケージを実行する場合に主に使用されます。This parameter is used primarily when you execute the package from Visual StudioVisual Studio.

  • /Rem comment:(省略可)。/Rem comment: (Optional). コマンド プロンプトまたはコマンド ファイルにコメントを含めます。Includes comments on the command prompt or in command files. 引数は省略可能です。The argument is optional. comment の値は、引用符で囲むか、空白を含まない文字列を指定する必要があります。The value of comment is a string that must be enclosed in quotation marks, or contain no white space. 引数を指定しない場合、空白行が挿入されます。If no argument is specified, a blank line is inserted. comment の値はコマンド初期フェーズで破棄されます。comment values are discarded during the command sourcing phase.

  • /Rep[orting] level [ ;event_guid_or_name[ ;event_guid_or_name[...]]:(省略可)。/Rep[orting] level [;event_guid_or_name[;event_guid_or_name[...]]: (Optional). レポートするメッセージの種類を指定します。Specifies what types of messages to report. level に使用できるレポート オプションは次のとおりです。The available reporting options for level are as follows:

    N レポートしません。N No reporting.

    E エラーがレポートされます。E Errors are reported.

    W 警告がレポートされます。W Warnings are reported.

    I 情報メッセージがレポートされます。I Informational messages are reported.

    C カスタム イベントがレポートされます。C Custom events are reported.

    D データ フロー タスク イベントがレポートされます。D Data Flow task events are reported.

    P 進行状況がレポートされます。P Progress is reported.

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

    V および N の引数は、他のすべての引数と同時には使用できないため、単独で指定する必要があります。The arguments of V and N are mutually exclusive to all other arguments; they must be specified alone. /Reporting オプションが指定されない場合、既定のレベルは E (エラー)、 W (警告)、および P (進行状況) になります。If the /Reporting option is not specified then the default level is E (errors), W (warnings), and P (progress).

    すべてのイベントの先頭には、"YY/MM/DD HH:MM:SS" の形式のタイムスタンプが付きます。また使用可能な場合は、GUID または表示名も付加されます。All events are preceded with a timestamp in the format "YY/MM/DD HH:MM:SS", and a GUID or friendly name if available.

    省略可能なパラメーターの event_guid_or_name には、ログ プロバイダーに関する例外のリストを指定します。The optional parameter event_guid_or_name is a list of exceptions to the log providers. この例外で指定されるイベントは、ログに記録されません。指定されないイベントがログに記録されます。The exception specifies the events that are not logged that otherwise might have been logged.

    既定でログに記録されないイベントは、除外する必要はありません。You do not have to exclude an event if the event is not ordinarily logged by default

  • /Res[tart] {deny | force | ifPossible}:(省略可)。/Res[tart] {deny | force | ifPossible}: (Optional). パッケージの CheckpointUsage プロパティの新しい値を指定します。Specifies a new value for the CheckpointUsage property on the package. パラメーターの意味は次のとおりです。The meaning of the parameters are as follows:

    denyCheckpointUsage プロパティを DTSCU_NEVER」を参照してください。Deny Sets CheckpointUsage property to DTSCU_NEVER.

    forceCheckpointUsage プロパティを DTSCU_ALWAYS」を参照してください。Force Sets CheckpointUsage property to DTSCU_ALWAYS.

    ifPossibleCheckpointUsage プロパティを DTSCU_IFEXISTS」を参照してください。ifPossible Sets CheckpointUsage property to DTSCU_IFEXISTS.

    値が指定されない場合は、既定値の force が使用されます。The default value of force is used if no value is specified.

  • /Set [$Sensitive::]propertyPath;value:(省略可)。/Set [$Sensitive::]propertyPath;value: (Optional). パッケージ内のパラメーター、変数、プロパティ、コンテナー、ログ プロバイダー、Foreach 列挙子、または接続の構成をオーバーライドします。Overrides the configuration of a parameter, variable, property, container, log provider, Foreach enumerator, or connection within a package. このオプションを指定すると、 /SetpropertyPath 引数を、指定された値に変更します。When this option is used, /Set changes the propertyPath argument to the value specified. 複数の /Set オプションを指定できます。Multiple /Set options can be specified.

    /Set オプションは /F[ile] オプションと共に使用できます。また。 /Set オプションは /ISServer オプションまたは /Project オプションと共に使用することもできます。In addition to using the /Set option with the /F[ile] option, you can also use the /Set option with the /ISServer option or the /Project option. /Set/Projectと共に使用すると、 /Set によってパラメーター値が設定されます。When you use /Set with /Project, /Set sets parameter values. /Set/ISServerと共に使用すると、 /Set によってプロパティのオーバーライドが設定されます。When you use /Set with /ISServer, /Set sets property overrides. また、 /Set/ISServerと共に使用すると、オプションの $Sensitive プレフィックスを使用して、 Integration ServicesIntegration Services サーバーでプロパティが機密として扱われるよう指定できます。In addition, when you use /Set with /ISServer, you can use the optional $Sensitive prefix to indicate that the property should be treated as sensitive on the Integration ServicesIntegration Services server.

    パッケージ構成ウィザードを実行して、 propertyPath の値を確認できます。You can determine the value of propertyPath by running the Package Configuration Wizard. 最後の [ウィザードの完了] ページに選択したアイテムのパスが表示されるので、これをコピーして貼り付けることができます。The paths for items that you select are displayed on the final Completing the Wizard page, and can be copied and pasted. この操作のみが目的でウィザードを使用した場合は、パスをコピーした後、ウィザードを取り消してください。If you have used the wizard only for this purpose, you can cancel the wizard after you copy the paths.

    ファイル システムに保存されているパッケージを実行して、変数に新しい値を指定する例を次に示します。The following is an example of executing a package that is saved in the file system and providing a new value for a variable:

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

    .ispac プロジェクト ファイルからパッケージを実行して、パッケージとプロジェクトのパラメーターを指定する例を次に示します。The following example of running a package from the .ispac project file and setting package and project parameters.

    /Project c:\project.ispac /Package Package1.dtsx /SET \Package.Variables[$Package::Parameter];1 /SET \Package.Variables[$Project::Parameter];1

    /Set オプションを使用すると、パッケージ構成を読み込む場所を変更することができます。You can use the /Set option to change the location from which package configurations are loaded. ただし、 /Set オプションを使用しても、デザイン時の構成で指定した値をオーバーライドすることはできません。However, you cannot use the /Set option to override a value that was specified by a configuration at design time. パッケージ構成が適用されるしくみについては、「 Package Configurations 」 (パッケージ構成) および「 SQL Server 2016 における Integration Services 機能の動作の変更」を参照してください。To understand how package configurations are applied, see Package Configurations and Behavior Changes to Integration Services Features in SQL Server 2016.

  • /Ser[ver] server:(省略可)。/Ser[ver] server: (Optional). /SQL または /DTS オプションが指定されている場合、このオプションにはパッケージを取得するサーバーの名前を指定します。When the /SQL or /DTS option is specified, this option specifies the name of the server from which to retrieve the package. /Server オプションを省略して /SQL オプションまたは /DTS オプションを指定した場合、ローカル サーバーに対してパッケージの実行が試行されます。If you omit the /Server option and the /SQL or /DTS option is specified, package execution is tried against the local server. server_instance 値は引用符で囲むことができます。The server_instance value may be quoted.

    /Ser[ver] オプションが指定されている場合、 /ISServer オプションは必須です。The /Ser[ver] option is required when the /ISServer option is specified.

  • /SQ[L] package_path:SQL ServerSQL Servermsdb データベースに格納されているパッケージを読み込みます。/SQ[L] package_path: Loads a package that is stored in SQL ServerSQL Server, in msdb database. msdb データベースに格納されているパッケージは、パッケージ配置モデルを使用して配置されます。Packages that are stored in the msdb database, are deployed using the package deployment model. プロジェクト配置モデルを使用して、 Integration ServicesIntegration Services サーバーに配置されているパッケージを実行するには、 /ISServer オプションを使用します。To run packages that are deployed to the Integration ServicesIntegration Services server using the project deployment model, use the /ISServer option. パッケージとプロジェクトの配置モデルの詳細については、「 Deployment of Projects and Packages」を参照してください。For more information about the package and project deployment models, see Deployment of Projects and Packages.

    package_path 引数には、取得するパッケージの名前を指定します。The package_path argument specifies the name of the package to retrieve. パス名を指定する場合、パス内のフォルダーの最後には円記号 ("\") を指定します。If folders are included in the path, they are terminated with backslashes ("\"). Package_path 値は引用符で囲むことができます。The package_path value can be quoted. package_path 引数に指定するパスまたはファイル名に空白文字を含める場合は、package_path 引数を引用符で囲む必要があります。If the path or file name specified in the package_path argument contains a space, you must put quotation marks around the package_path argument.

    /User/Password/Server の各オプションは、 /SQL オプションと共に使用できます。You can use the /User, /Password, and /Server options together with the /SQL option.

    /User オプションを省略した場合、パッケージへのアクセスに Windows 認証が使用されます。If you omit the /User option, Windows Authentication is used to access the package. /User オプションを使用する場合、指定する /User ログイン名は SQL ServerSQL Server 認証に関連付けられます。If you use the /User option, the /User login name specified is associated with SQL ServerSQL Server Authentication.

    /Password オプションは、 /User オプションと共に使用する必要があります。The /Password option is used only together with the /User option. /Password オプションを使用する場合、パッケージは指定されたユーザー名とパスワード情報を使用してアクセスされます。If you use the /Password option, the package is accessed with the user name and password information provided. /Password オプションを省略した場合、空白のパスワードが使用されます。If you omit the /Password option, a blank password is used.

    重要!!IMPORTANT!! 可能な場合は、Windows 認証を使用します。When possible, use Windows authentication.

    /Server オプションを省略した場合、 SQL ServerSQL Server の既定のローカル インスタンスが使用されます。If the /Server option is omitted, the default local instance of SQL ServerSQL Server is assumed.

    /SQL オプションは、 /DTS オプションまたは /File オプションと同時に使用できません。The /SQL option cannot be used together with the /DTS or /File option. 複数のオプションが指定された場合、 dtexec は失敗します。If multiple options are specified, dtexec fails.

  • /Su[m] :(省略可)。/Su[m]: (Optional). 後続のコンポーネントが受け取る行数を示す増分カウンターを表示します。Shows an incremental counter that contains the number of rows that will be received by the next component.

  • /U[ser] user_name:(省略可)。/U[ser] user_name: (Optional). SQL ServerSQL Server 認証によって保護されているパッケージの取得を可能にします。Allows the retrieval of a package that is protected by SQL ServerSQL Server Authentication. このオプションは、 /SQL オプションが指定されている場合にのみ使用されます。This option is used only when the /SQL option is specified. User_name 値は引用符で囲むことができます。The user_name value can be quoted.

    重要!!IMPORTANT!! 可能な場合は、Windows 認証を使用します。When possible, use Windows authentication.

  • /Va[lidate] :(省略可)。/Va[lidate]: (Optional). 検証フェーズ後、パッケージの実行を停止します。パッケージは実際には実行されません。Stops the execution of the package after the validatation phase, without actually running the package. 検証を行う場合、 /WarnAsError オプションを指定すると、 dtexec は警告をエラーとして処理するので、検証中に警告が発生した場合にパッケージが失敗します。During validation, use of the /WarnAsError option causes dtexec to treat a warning as an error; therefore the package fails if a warning occurs during validation.

  • /VerifyB[uild] major[ ;minor[ ;build]]:(省略可)。/VerifyB[uild] major[;minor[;build]]: (Optional). 検証フェーズ中に、パッケージのビルド番号を、 majorminor、および build 引数に指定されたビルド番号に対して検証します。Verifies the build number of a package against the build numbers that were specified during the verification phase in the major, minor, and build arguments. 不一致が発生した場合、パッケージは実行されません。If a mismatch occurs, the package will not execute.

    値は長整数型です。The values are long integers. 引数は次の 3 つの形式のいずれかになります。 major の値は必須です。The argument can have one of three forms, with a value for major always required:

    • majormajor

    • major;minormajor;minor

    • major; minor; buildmajor; minor; build

  • /VerifyP[ackageID] packageID:(省略可)。/VerifyP[ackageID] packageID: (Optional). 実行するパッケージの GUID を、 package_id 引数に指定された値と比較して検証します。Verifies the GUID of the package to be executed by comparing it to the value specified in the package_id argument.

  • /VerifyS[igned] :(省略可)。/VerifyS[igned]: (Optional). Integration ServicesIntegration Services でパッケージのデジタル署名を確認します。Causes Integration ServicesIntegration Services to check the digital signature of the package. パッケージが署名されていないか、署名が有効でない場合、パッケージは失敗します。If the package is not signed or the signature is not valid, the package fails. 詳細については、「 デジタル署名を使用してパッケージのソースを特定する」を参照してください。For more information, see Identify the Source of Packages with Digital Signatures.

    重要!!IMPORTANT!! パッケージの署名を確認するように構成した場合、 Integration ServicesIntegration Services によって確認されるのは、デジタル署名が存在するかどうか、有効かどうか、および信頼関係のある発行元の署名であるかどうかのみです。When configured to check the signature of the package, Integration ServicesIntegration Services only checks whether the digital signature is present, is valid, and is from a trusted source. Integration ServicesIntegration Services では、パッケージが変更されたかどうかは確認されません。does not check whether the package has been changed.

    注: オプションの BlockedSignatureStates レジストリ値では、 SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) または dtexec コマンド ラインで設定されたデジタル署名オプションよりも制限が厳しい設定を指定できます。NOTE: The optional BlockedSignatureStates registry value can specify a setting that is more restrictive than the digital signature option set in SQL Server Data Tools (SSDT)SQL Server Data Tools (SSDT) or at the dtexec command line. この場合、制限が厳しい方のレジストリ設定が他の設定をオーバーライドします。In this situation, the more restrictive registry setting overrides the other settings.

  • /VerifyV[ersionID] versionID:(省略可)。/VerifyV[ersionID] versionID: (Optional). パッケージの検証フェーズ中に、実行されるパッケージのバージョン GUID を version_id 引数に指定された値と比較して検証します。Verifies the version GUID of a package to be executed by comparing it to the value specified in the version_id argument during package Validation Phase.

  • /VLog [Filespec] :(省略可)。/VLog [Filespec]: (Optional). すべての Integration Services パッケージ イベントを、パッケージの設計時に有効にしたログ プロバイダーに書き込みます。Writes all Integration Services package events to the log providers that were enabled when the package was designed. Integration Services でテキスト ファイルのログ プロバイダーを有効にし、指定したテキスト ファイルにログ イベントを書き込むには、パスとファイル名を Filespec パラメーターとして含めます。To have Integration Services enable a log provider for text files and write log events to a specified text file, include a path and file name as the Filespec parameter.

    Filespec パラメーターを含めない場合、Integration Services でテキスト ファイルのログ プロバイダーが有効になりません。If you do not include the Filespec parameter, Integration Services will not enable a log provider for text files. Integration Services では、パッケージの設計時に有効にしたログ プロバイダーに対してのみ、ログ イベントが書き込まれます。Integration Services will only write log events to the log providers that were enabled when the package was designed.

  • /W[arnAsError] :(省略可)。/W[arnAsError]: (Optional). パッケージは警告をエラーと判断するので、検証中に警告が発生した場合にはパッケージが失敗します。Causes the package to consider a warning as an error; therefore, the package will fail if a warning occurs during validation. 検証中に警告が発生せず、 /Validate オプションが指定されていない場合、パッケージは実行されます。If no warnings occur during validation and the /Validate option is not specified, the package is executed.

  • /X86:(省略可)。/X86: (Optional). SQL ServerSQL Server エージェントは 64 ビット コンピューター上で 32 ビット モードでパッケージを実行します。Causes SQL ServerSQL Server Agent to run the package in 32-bit mode on a 64-bit computer. このオプションは、次に示す条件が満たされた場合に SQL ServerSQL Server エージェントによって設定されます。This option is set by SQL ServerSQL Server Agent when the following conditions are true:

    • ジョブ ステップの種類が [SQL Server Integration Services パッケージ] であること。The job step type is SQL Server Integration Services package.

    • [新しいジョブ ステップ] ダイアログ ボックスの [実行オプション] タブで [32 ビット ランタイムを使用] オプションが選択されていること。The Use 32 bit runtime option on the Execution options tab of the New Job Step dialog box is selected.

    このオプションは、ストアド プロシージャまたは SQL Server 管理オブジェクト (SMO) を使用してジョブをプログラムにより作成することで、 SQL ServerSQL Server エージェント ジョブ ステップに設定することもできます。You can also set this option for a SQL ServerSQL Server Agent job step by using stored procedures or SQL Server Management Objects (SMO) to programmatically create the job.

    このオプションは、 SQL ServerSQL Server エージェントのみに使用されます。This option is only used by SQL ServerSQL Server Agent. コマンド プロンプトで dtexec ユーティリティを実行している場合、このオプションは無視されます。This option is ignored if you run the dtexec utility at the command prompt.

解説Remarks

コマンド オプションの指定順序は、パッケージの実行方法に影響します。The order in which you specify command options can influence the way in which the package executes:

  • オプションは、コマンド ライン上で指定されている順に処理されます。Options are processed in the order they are encountered on the command line. コマンド ファイルは、コマンド ラインで指定されているとおりに読み取られます。Command files are read in as they are encountered on the command line. コマンド ファイル内のコマンドも指定されている順に処理されます。The commands in the command file are also processed in the order they are encountered.

  • 同じオプション、パラメーター、または変数が、同じコマンド ライン ステートメントに複数指定されている場合は、最後に指定されているものが優先されます。If the same option, parameter, or variable appears in the same command line statement more than one time, the last instance of the option takes precedence.

  • /Set オプションと /ConfigFile オプションは、指定されている順に処理されます。/Set and /ConfigFile options are processed in the order they are encountered.

使用例Examples

次の例では、 dtexec コマンド プロンプト ユーティリティを使用して SQL ServerSQL Server Integration ServicesIntegration Services パッケージを構成および実行する方法について説明します。The following examples demonstrate how to use the dtexec command prompt utility to configure and execute SQL ServerSQL Server Integration ServicesIntegration Services packages.

パッケージの実行Running Packages

Windows 認証を使用する SSISSSIS に保存されている SQL ServerSQL Server パッケージを実行するには、次のコードを使用します。To execute an SSISSSIS package saved to SQL ServerSQL Server using Windows Authentication, use the following code:

dtexec /sq pkgOne /ser productionServer  

SSIS パッケージ ストアの [ファイル システム] フォルダーに保存されている SSISSSIS パッケージを実行するには、次のコードを使用します。To execute an SSISSSIS package saved to the File System folder in the SSIS Package Store, use the following code:

dtexec /dts "\File System\MyPackage"  

Windows 認証が使用されていて、 SQL ServerSQL Server に保存されているパッケージを実行せずに検証するには、次のコードを使用します。To validate a package that uses Windows Authentication and is saved in SQL ServerSQL Server without executing the package, use the following code:

dtexec /sq pkgOne /ser productionServer /va  

ファイル システムに保存されている SSISSSIS パッケージを実行するには、次のコードを使用します。To execute an SSISSSIS package that is saved in the file system, use the following code:

dtexec /f "c:\pkgOne.dtsx"   

ファイル システムに保存されている SSISSSIS パッケージの実行、およびログ オプションの指定を行うには、次のコードを使用します。To execute an SSISSSIS package that is saved in the file system, and specify logging options, use the following code:

dtexec /f "c:\pkgOne.dtsx" /l "DTS.LogProviderTextFile;c:\log.txt"  

Windows 認証が使用され、 SQL ServerSQL Serverの既定のローカル インスタンスに保存されているパッケージの実行、および実行前にバージョンの確認を行うには、次のコードを使用します。To execute a package that uses Windows Authentication and is saved to the default local instance of SQL ServerSQL Server, and verify the version before it is executed, use the following code:

dtexec /sq pkgOne /verifyv {c200e360-38c5-11c5-11ce-ae62-08002b2b79ef}  

ファイル システムに保存されているが、外部で構成されている SSISSSIS パッケージを実行するには、次のコードを使用します。To execute an SSISSSIS package that is saved in the file system and configured externally, use the following code:

dtexec /f "c:\pkgOne.dtsx" /conf "c:\pkgOneConfig.cfg"  

注: /SQL、/DTS、または /FILE オプションの package_path または filespec 引数は、パスまたはファイル名に空白文字が含まれる場合、引用符で囲む必要があります。NOTE: The package_path or filespec arguments of the /SQL, /DTS, or /FILE options must be enclosed in quotation marks if the path or file name contains a space. 引数を引用符で囲まないと、空白文字を引数に含めることはできません。If the argument is not enclosed in quotation marks, the argument cannot contain white space.

ログ オプションLogging Option

ログ エントリの種類が A、B、C の 3 つある場合、次のように、パラメーターを指定せずに ConsoleLog オプションを使用すると、3 つすべてのログの種類がすべてのフィールドと共に表示されます。If there are three log entry types of A, B, and C, the following ConsoleLog option without a parameter displays all three log types with all fields:

/CONSOLELOG  

次のオプションを指定すると、すべてのログの種類が、Name 列および Message 列のみと共に表示されます。The following option displays all log types, but with the Name and Message columns only:

/CONSOLELOG NM  

次のオプションを指定すると、A の種類のログ エントリのみが、すべての列と共に表示されます。The following option displays all columns, but only for log entry type A:

/CONSOLELOG I;LogEntryTypeA  

次のオプションを指定すると、A の種類のログ エントリのみが Name 列および Message 列と共に表示されます。The following option displays only log entry type A, with Name and Message columns:

/CONSOLELOG NM;I;LogEntryTypeA  

次のオプションを指定すると、A および B の種類のログ エントリが表示されます。The following option displays log entries for log entry types A and B:

/CONSOLELOG I;LogEntryTypeA;LogEntryTypeB  

複数の ConsoleLog オプションを指定すると、同じ結果を得ることができます。You can achieve the same results by using multiple ConsoleLog options:

/CONSOLELOG I;LogEntryTypeA /CONSOLELOG I;LogEntryTypeB  

パラメーターなしで ConsoleLog オプションを指定すると、すべてのフィールドが表示されます。If the ConsoleLog option is used without parameters, all fields are displayed. 次の指定に list_options パラメーターを含めると、A の種類のログ エントリのみがすべてのフィールドと共に表示されます。The inclusion of a list_options parameter causes the following to displays only log entry type A, with all fields:

/CONSOLELOG NM;I;LogEntryTypeA /CONSOLELOG  

次の例では、種類 A のログ エントリを除くすべてのログ エントリ (種類 B と C) が表示されます。The following displays all log entries except log entry type A: that is, it displays log entry types B and C:

/CONSOLELOG E;LogEntryTypeA  

次のように複数の ConsoleLog オプションを使用し、単一のログ エントリを除外することで、前の例と同じ結果が得られます。The following example achieves the same results by using multiple ConsoleLog options and a single exclusion:

/CONSOLELOG E;LogEntryTypeA /CONSOLELOG  
/CONSOLELOG E;LogEntryTypeA /CONSOLELOG E;LogEntryTypeA  
/CONSOLELOG E;LogEntryTypeA;LogEntryTypeA  

ログ ファイルの種類が包含一覧と除外一覧の両方に指定されている場合、そのログ ファイルは除外されるため、次の例ではログ メッセージは表示されません。The following example displays no log messages, because when a log file type is found in both the included and excluded lists, it will be excluded.

/CONSOLELOG E;LogEntryTypeA /CONSOLELOG I;LogEntryTypeA  

SET オプションSET Option

/SET オプションの使用方法の例を次に示します。これは、パッケージのプロパティ値または変数値をコマンド ラインからパッケージを起動するときに変更します。The following example shows how to use the /SET option, which lets you change the value of any package property or variable when you start the package from the command line.

/SET \package\DataFlowTask.Variables[User::MyVariable].Value;newValue  

プロジェクトのオプションProject Option

/Project オプションと /Package オプションの使用例を次に示します。The following example shows how to use the /Project and the /Package option.

/Project c:\project.ispac /Package Package1.dtsx  

次の例は、 /Project オプションと /Package オプションを使用してパッケージとプロジェクトのパラメーターを設定する方法を示しています。The following example shows how to use the /Project and /Package options, and set package and project parameters.

/Project c:\project.ispac /Package Package1.dtsx /SET \Package.Variables[$Package::Parameter];1 /SET \Package.Variables[$Project::Parameter];1  
  

ISServer のオプションISServer Option

/ISServer オプションの使用例を次に示します。The following example shows how to use the /ISServer option.

dtexec /isserver "\SSISDB\MyFolder\MyProject\MyPackage.dtsx" /server "."  

次の例は、 /ISServer オプションを使用してプロジェクトと接続マネージャーのパラメーターを設定する方法を示しています。The following example shows how to use the /ISServer option and set project and connection manager parameters.

/Server localhost /ISServer "\SSISDB\MyFolder\Integration Services Project1\Package.dtsx" /Par "$Project::ProjectParameter(Int32)";1 /Par "CM.SourceServer.InitialCatalog";SourceDB  
  

www.mattmasson.com のブログ エントリ「 終了コード、DTEXEC、および SSIS カタログBlog entry, Exit Codes, DTEXEC, and SSIS Catalog, on www.mattmasson.com.