dtexec 实用工具

适用于: SQL Server Azure 数据工厂中的 SSIS Integration Runtime

dtexec 命令提示实用工具用于配置和执行 SQL Server Integration Services 包。 使用 dtexec 实用工具,可以访问所有包配置和执行功能,如参数、连接、属性、变量、日志和进度指示器等。 使用 dtexec 实用工具,可以加载来自以下源的包:Integration Services 服务器、.ispac 项目文件、 Microsoft SQL Server 数据库、SSIS 包存储区和文件系统。

备注

使用当前版本的 dtexec 实用工具来运行使用旧版 Integration Services 创建的包时,该实用工具会临时将包升级到当前的包格式。 不过,你不能使用 dtexec 实用工具保存升级的包。 有关如何将包永久地升级到当前版本的详细信息,请参阅 Upgrade Integration Services Packages

本主题包含下列部分:

Integration Services 服务器和项目文件

当你使用 dtexec 在 Integration Services 服务器上运行包时,dtexec 会调用 catalog.create_execution(SSISDB 数据库)catalog.set_execution_parameter_value(SSISDB 数据库)catalog.start_execution(SSISDB 数据库)存储过程来创建执行、设置参数值并启动执行。 可以在服务器的相关视图中或使用 SQL Server Management Studio中提供的标准报告来查看所有执行日志。 有关报表的详细信息,请参阅 Integration Services 服务器的报表

以下是在 Integration Services 服务器上执行包的一个示例。

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] 用于指定项目路径和包流名称。 通过从 运行 “Integration Services 项目转换向导” SQL Server Management Studio将项目转换为项目部署模型时,该向导生成一个 .ispac 项目文件。 有关详细信息,请参阅部署 Integration Services (SSIS) 项目和包

你可以使用 dtexec 与第三方计划工具来计划部署到 Integration Services 服务器的包。

64 位计算机上的安装注意事项

在 64 位计算机上, Integration Services 将安装 64 位版本的 dtexec 实用工具 (dtexec.exe)。 如果需要以 32 位模式运行某些包,则必须安装 32 位版本的 dtexec 实用工具。 若要安装 32 位版本的 dtexec 实用工具,必须在安装过程中选择“客户端工具”或 SQL Server Data Tools (SSDT) 。

默认情况下,同时安装了 64 位和 32 位版本的 Integration Services 命令提示实用工具的 64 位计算机将在命令提示符处运行 32 位版本。 运行 32 位版本的原因是:在 PATH 环境变量中,32 位版本的目录路径显示在 64 位版本的目录路径之前。 (通常,32 位目录路径是 <drive>:\Program Files(x86)\Microsoft SQL Server\110\DTS\Binn,而 64 位目录路径是 <drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn。)

注意

如果使用 SQL Server 代理来运行此实用工具,则 SQL Server 代理会自动使用 64 位版本的实用工具。 SQL Server 代理使用注册表(而非 PATH 环境变量)来找到此实用工具的正确可执行文件。

若要确保在命令提示符处运行 64 位版本的实用工具,可以执行以下操作之一:

  • 打开命令提示符窗口,更改为包含 64 位版本的实用工具的目录 (<drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn),然后从该位置运行此实用工具。

  • 在命令提示符处,通过输入 64 位版本的实用工具的完整路径 (<drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn) 来运行此实用工具。

  • 通过将 64 位路径 (<drive>:\Program Files\Microsoft SQL Server\110\DTS\Binn) 置于 32 位路径 (<drive>:\ Program Files(x86)\Microsoft SQL Server\110\DTS\Binn) 之前,可永久更改 PATH 环境变量中路径的顺序。

有关使用并行安装的计算机的注意事项

当在已安装 SQL Server 2019 Integration Services (SSIS) 或 SQL Server 2005 Integration Services (SSIS) 的计算机上安装 SQL Server 2008 Integration Services (SSIS) 时,安装多个版本的 dtexec 实用工具。

若要确保运行正确的实用工具版本,请在命令提示符处,通过输入完整路径 (<drive>:\Program Files\Microsoft SQL Server\<version>\DTS\Binn) 来运行此实用工具。

执行的阶段

该实用工具的执行过程经历四个阶段。 这些阶段如下所列:

  1. 命令溯源阶段:命令提示符读取选项列表和已指定的参数。 如果遇到“/?”或“/HELP”选项,则会跳过所有后续阶段。

  2. 包加载阶段:加载 /SQL、/FILE 或 /DTS 选项指定的包 。

  3. 配置阶段:按以下顺序处理各个选项:

    • 设置包标志、变量和属性的选项。

    • 验证包版本和内部版本的选项。

    • 配置实用工具运行时行为(如报告)的选项。

  4. 验证和执行阶段:运行包,如果指定了 /VALIDATE 选项,则验证但不运行包 。

返回的退出代码

dtexec 实用工具返回的退出代码

运行包时, dtexec 可能会返回退出代码。 使用该退出代码填充 ERRORLEVEL 变量,然后可以在批处理文件的条件语句或分支逻辑中测试该变量的值。 下表列出了 dtexec 实用工具退出时可以设置的值。

说明
0 已成功执行包。
1 包失败。
3 用户取消了包。
4 实用工具找不到请求的包。 无法找到包。
5 实用工具无法加载请求的包。 无法加载包。
6 实用工具的命令行中有内部语法错误或语义错误。

语法规则

实用工具语法规则

所有选项必须以斜杠 (/) 或减号 (-) 开头。 此处显示的选项以斜杠 (/) 开始,但可用减号 (-) 替换。

如果参数包含空格,则必须用引号将该参数引起来。 如果没有使用引号将参数引起来,则该参数不能包含空格。

用引号引起来的字符串中的双引号表示转义单引号。

除密码外,其他选项和参数都不区分大小写。

从 xp_cmdshell 中使用 dtexec

从 xp_cmdshell 中使用 dtexec

可以从 xp_cmdshell 提示符处运行 dtexec。 以下示例显示如何运行名为 UpsertData.dtsx 的包并忽略返回代码:

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

以下示例显示如何运行相同的包并捕获返回代码:

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

重要

在 Microsoft SQL Server 中,新安装中将默认禁用 xp_cmdshell 选项。 运行 sp_configure 系统存储过程可以启用此选项。 有关详细信息,请参阅 xp_cmdshell 服务器配置选项

从 Bash 中使用 dtexec

Bash shell 是适用于 Linux 的常用 shell。 它还可在 Windows 上使用。 可以从 Bash 提示符下运行 dtexec。 请注意,分号 (;) 在 Bash 中是一个命令分隔符运算符。 使用 /Conn[ection]/Par[arameter]/Set 选项将值传递到包时,这一点尤其重要,因为它们使用分号来分隔提供的项的名称和值。 下面的示例演示了使用 Bash 将值传入包时正确转义分号和其他项的方法:

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

语法

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

parameters

  • /? [option_name] :(可选)。 显示命令提示符选项,或显示指定的 option_name 的帮助,然后关闭实用工具。

    如果指定 option_name 参数,则 dtexec 将启动 SQL Server 联机丛书并显示 dtexec 实用工具主题。

  • /Ca[llerInfo] :(可选)。 指定有关包执行的其他信息。 使用 SQL Server 代理运行包时,代理设置此参数以指示包执行由 SQL Server 代理调用。 从命令行运行 dtexec 实用工具时,忽略此参数。

  • /CheckF[ile] filespec:(可选)。 将包的 CheckpointFileName 属性设置为 filespec中指定的路径和文件。 重新启动包时将使用此文件。 如果指定了该选项并且未提供文件名值,则包的 CheckpointFileName 将被设置为空字符串。 如果不指定该选项,则保留包中的值。

  • /CheckP[ointing] {on\off}:(可选)。 设置一个值,用于确定包执行期间包是否使用检查点。 值 on 指定要重新运行失败的包。 重新运行失败的包时,运行时引擎将使用检查点文件,以便从失败点重新启动包。

    如果声明该选项时未提供值,则默认值为“on”。 如果值设置为“on”,但找不到检查点文件,则包执行将失败。 如果不指定该选项,则保留包中设置的值。 有关详细信息,请参阅 通过使用检查点重新启动包

    dtexec 的 /CheckPointing on 选项等效于将包的 SaveCheckpoints 属性设置为 True,并将 CheckpointUsage 属性设置为“Always”。

  • /Com[mandFile] filespec:(可选)。 指定要使用 dtexec运行的命令选项。 打开 filespec 中指定的文件,并读取该文件中的选项,直到在文件中找到 EOF。 filespec 是一个文本文件。 filespec 参数指定与包执行关联的命令文件的文件名和路径。

  • /Conf[igFile] filespec:(可选)。 指定要从中提取值的配置文件。 使用该选项,可以设置一个与设计包时指定的配置不同的运行时配置。 可以将不同的配置设置存储在 XML 配置文件中,然后在执行包之前使用 /ConfigFile 选项加载这些设置。

    可以使用 /ConfigFile 选项在运行时加载在设计时未指定的其他配置。 不过,不能使用 /ConfigFile 选项来替换在设计时也指定了的配置值。 若要了解如何应用包配置,请参阅 Package Configurations

  • /Conn[ection] id_or_name;connection_string [[;id_or_name;connection_string]...]:(可选)。 指定带有指定名称或 GUID 的连接管理器位于包中,并指定了连接字符串。

    该选项要求同时指定两个参数:必须在 id_or_name 参数中提供连接管理器名称或 GUID,并且在 connection_string 参数中指定有效的连接字符串。 有关详细信息,请参阅 Integration Services (SSIS) 连接

    在运行时,可以使用 /Connection 选项从在设计时指定的位置之外的某个位置加载包配置。 这些配置的值随后将替换最初指定的值。 不过,可以将 /Connection 选项仅用于使用连接管理器的配置,如 SQL Server 配置。 若要了解如何应用包配置,请参阅 包配置SQL Server 2016 中 Integration Services 功能的行为更改

  • /Cons[oleLog] [[displayoptions];[list_optionssrc_name_or_guid]...] :(可选)。 在包执行过程中,在控制台显示指定的日志项。 如果省略该选项,则不会在控制台中显示日志项。 如果指定该选项时不带限制显示的参数,则会显示所有日志项。 若要限制控制台显示的日志项,可以使用 displayoptions 参数指定要显示的列,并使用 list_options 参数限制日志项类型。

    备注

    在 Integration Services 服务器上使用 /ISSERVER 参数运行包时,控制台输出受限,大多数 /Cons[oleLog] 选项不适用。 可以在服务器的相关视图中或使用 SQL Server Management Studio中提供的标准报告来查看所有执行日志。 有关报表的详细信息,请参阅 Integration Services 服务器的报表

    displayoptions 值包括:

    • N(名称)

    • C(计算机)

    • O(操作员)

    • S(源名称)

    • G(源 GUID)

    • X(执行 GUID)

    • M(消息)

    • T(开始和结束时间)

    list_options 值包括:

    • I — 指定包含列表。 仅记录指定的源名称或 GUID。

    • E — 指定排除列表。 不记录指定的源名称或 GUID。

    • 为包含或排除指定的 src_name_or_guid 参数是事件名称、源名称或源 GUID。

    如果在同一个命令提示符中使用多个 /ConsoleLog 选项,它们的相互影响如下:

    • 它们的出现顺序没有影响。

    • 如果命令行中不存在包含列表,将对所有类型日志项应用排除列表。

    • 如果命令行中存在包含列表,将对所有包含列表统一应用排除列表。

    有关 /ConsoleLog 选项的若干示例,请参阅 备注 部分。

  • /D[ts] package_path:(可选)。 从 SSIS 包存储区加载包。 使用旧的包部署模型部署存储在 SSIS 包存储区中的包。 若要使用项目部署模型运行部署到 Integration Services 服务器的包,请使用 /ISServer 选项。 有关包和项目部署模型的详细信息,请参阅 Deployment of Projects and Packages

    package_path 参数指定 SSIS 包的相对路径,从 SSIS 包存储的根目录开始,包括 SSIS 包的名称。 如果 package_path 参数中指定的路径或文件名包含空格,则必须在 package_path 参数两侧加上引号。

    /DTS 选项不能与 /File/SQL 选项一起使用。 如果指定多个选项, dtexec 将失败。

  • /De[crypt] password:(可选)。 设置加载使用密码加密的包时所用的解密密码。

  • (可选)在包运行期间发生一个或多个指定事件时,创建调试转储文件 .mdmp 和 .tmp。 error code 参数指定将触发系统创建调试转储文件的事件代码类型:错误、警告或信息 。 若要指定多个事件代码,请用分号 (;) 分隔每个 error code 参数。 不要对 error code 参数使用引号。

    以下示例在发生 DTS_E_CANNOTACQUIRECONNECTIONFROMCONNECTIONMANAGER 错误时生成调试转储文件。

    /Dump 0xC020801C  
    

    /Dump error code::默认情况下,Integration Services 将调试转储文件存储在 <drive>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps 文件夹中。

    注意

    调试转储文件可能包含敏感信息。 使用访问控制列表 (ACL) 来限制对这些文件的访问,或将文件复制到具有受限访问权限的文件夹中。 例如,在将调试文件发送给 Microsoft 支持服务部门之前,建议您删除所有敏感信息或机密信息。

    若要将此选项应用到 dtexec 实用工具运行的所有包,请将 DumpOnCodes REG_SZ 值添加到 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath 注册表项。 DumpOnCodes 中的数据值指定将触发系统创建调试转储文件的错误代码或代码。 多个错误代码必须以分号 (;) 分隔。

    如果将 DumpOnCodes 值添加到注册表项,并使用 /Dump 选项,系统将创建基于这两个设置的调试转储文件。

    有关调试转储文件的详细信息,请参阅 Generating Dump Files for Package Execution

  • /DumpOnError:(可选)在包运行期间发生任何错误时,创建调试转储文件 .mdmp 和 .tmp。

    默认情况下,Integration Services 将调试转储文件存储在 <drive>:\Program Files\Microsoft SQL Server\110\Shared\ErrorDumps 文件夹中。

    备注

    调试转储文件可能包含敏感信息。 使用访问控制列表 (ACL) 来限制对这些文件的访问,或将文件复制到具有受限访问权限的文件夹中。 例如,在将调试文件发送给 Microsoft 支持服务部门之前,建议您删除所有敏感信息或机密信息。

    若要将此选项应用到 dtexec 实用工具运行的所有包,请将 DumpOnError REG_DWORD 值添加到 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS\Setup\DtsPath 注册表项。 DumpOnError REG_DWORD 值决定了 /DumpOnError 选项是否需要与 dtexec 实用工具一起使用:

    • 非零数据值指示出现任意错误时系统将创建调试转储文件,不论是否将 /DumpOnError 选项与 dtexec 实用工具一起使用。

    • 零数据值指示,除非将 /DumpOnError 选项与 dtexec 实用工具一起使用,否则系统不会创建调试转储文件。

    有关调试转储文件的详细信息,请参阅 Generating Dump Files for Package Execution

  • /Env[Reference] environment reference ID:(可选)。 为部署到 Integration Services 服务器的包指定包执行使用的环境引用 (ID)。 配置为绑定到变量的参数将使用环境中包含的变量值。

    /Env[Reference] 选项与 /ISServer/Server 选项一起使用。

    此参数由 SQL Server 代理使用。
    -- /F[ile] filespec:(可选)。 加载保存在文件系统中的包。 使用旧的包部署模型部署保存在文件系统中的包。 若要使用项目部署模型运行部署到 Integration Services 服务器的包,请使用 /ISServer 选项。 有关包和项目部署模型的详细信息,请参阅 Deployment of Projects and Packages

filespec 参数指定包的路径和文件名。 可以将路径指定为通用命名约定 (UNC) 路径或本地路径。 如果 filespec 参数中指定的路径或文件名包含空格,则必须在 filespec 参数两侧加上引号。

  • /File 选项不能与 /DTS/SQL 选项一起使用。 如果指定多个选项, dtexec 将失败。

  • /H[elp] [option_name ]:(可选)。 显示选项的帮助,或显示指定的 option_name 的帮助,同时关闭实用工具。

    如果指定 option_name 参数,则 dtexec 将启动 SQL Server 联机丛书并显示 dtexec 实用工具主题。

  • /ISServer packagepath:(可选)。 运行部署到 Integration Services 服务器的包。 PackagePath 参数指定部署到 Integration Services 服务器的包的完整路径和文件名。 如果 PackagePath 参数中指定的路径或文件名包含空格,则必须在 PackagePath 参数两侧加上引号。

    包格式如下所示:

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

    /Server 选项与 /ISSERVER 选项一起使用。 只有 Windows 身份验证可以在 SSIS 服务器上执行包。 当前 Windows 用户用于访问该包。 如果省略 /Server 选项,则假定使用 SQL Server 的默认本地实例。

    /ISSERVER 选项不能与 /DTS/SQL/File 选项一起使用。 如果指定多个选项,dtexec 将失败。

    此参数由 SQL Server 代理使用。

  • /L[ogger] classid_orprogid;configstring:(可选)。 将一个或多个日志提供程序与 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}

  • /M[axConcurrent] concurrent_executables:(可选)。 指定包可以同时执行的可执行文件数。 指定的值必须是非负整数或 -1。 如果值为 -1,则表示 SSIS 所允许的最大并发运行可执行文件数等于执行包的计算机上的处理器总数加二。

  • /Pack[age] PackageName:(可选)。 指定执行的包。 当从 Visual Studio执行包时,主要使用此参数。

  • /P[assword] password:(可选)。 允许检索受 SQL Server 身份验证保护的包。 该选项与 /User 选项一起使用。 如果省略 /Password 选项但使用 /User 选项,则使用空白密码。 password 值可以用引号引起来。

    重要

    请尽可能使用 Windows 身份验证。

  • /Par[ameter] [$Package:: | $Project:: | $ServerOption::] parameter_name [(data_type)]; literal_value :(可选)。 指定参数值。 可以指定多个 /Parameter 选项。 数据类型是作为字符串的 CLR TypeCodes。 对于非字符串参数,在括号中指定数据类型,前面接着参数名称。

    /Parameter 选项只能与 /ISServer 选项一起使用。

    使用 $Package、$Project 和 $ServerOption 前缀分别指示包参数、项目参数和服务器选项参数。 默认参数类型为包。

    以下示例执行一个包并为项目参数 (myparam) 提供 myvalue 以及为包参数 (anotherparam) 提供整数值 12。

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

    您还可以通过使用参数设置连接管理器属性。 可以使用 CM 前缀来表示连接管理器参数。

    在以下示例中,将 SourceServer 连接管理器的 InitialCatalog 属性设置为 ssisdb

    /parameter CM.SourceServer.InitialCatalog;ssisdb  
    

    在以下示例中,将 SourceServer 连接管理器的 ServerName 属性设置为一个句点 (.),用来指示本地服务器。

    /parameter CM.SourceServer.ServerName;.  
    
  • /Proj[ect] ProjectFile:(可选)。 指定从中检索执行的包的项目。 ProjectFile 参数指定 .ispac 文件名。 当从 Visual Studio执行包时,主要使用此参数。

  • /Rem comment:(可选)。 在命令提示符或命令文件中包含注释。 该参数可选。 comment 的值是字符串,必须用引号引起来或不含空格。 如果未指定参数,将插入一个空行。 命令选项确定阶段,将放弃comment 值。

  • /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 是日志提供程序的异常列表。 该异常指定本应记录但却未记录的事件。

    如果默认情况下通常不记录某个事件,则不必排除该事件。

  • /Res[tart] {deny | force | ifPossible} :(可选)。 为包的 CheckpointUsage 属性指定新值。 各参数的含义如下:

    DenyCheckpointUsage 属性设置为 DTSCU_NEVER

    ForceCheckpointUsage 属性设置为 DTSCU_ALWAYS

    ifPossibleCheckpointUsage 属性设置为 DTSCU_IFEXISTS

    如果不指定值,则使用默认值 force

  • /Set [$Sensitive::]propertyPath;value :(可选)。 覆盖包中参数、变量、属性、容器、日志提供程序、Foreach 枚举器或连接的配置。 使用该选项时, /Set 可将 propertyPath 参数更改为指定的值。 可以指定多个 /Set 选项。

    除了将 /Set 选项与 /F[ile] 选项一起使用之外,还可以将 /Set 选项与 /ISServer 选项或 /Project 选项一起使用。 将 /Set/Project一起使用时, /Set 用于设置参数值。 将 /Set/ISServer一起使用时, /Set 用于设置属性覆盖。 此外,将 /Set/ISServer一起使用时,可以使用可选的 $Sensitive 前缀指示应作为 Integration Services 服务器上的敏感项处理该属性。

    可以通过运行包配置向导确定 propertyPath 的值。 选定项的路径会显示在最后一个 “完成向导” 页中,可以进行复制和粘贴。 如果仅以此目的使用该向导,则可以在复制路径后取消它。

    以下示例执行文件系统中保存的包并为变量提供新值:

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

    以下示例从 .ispac 项目文件运行包并设置包参数和项目参数。

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

    可以使用 /Set 选项更改自其加载包配置的位置。 但是,不能使用 /Set 选项覆盖设计时某个配置所指定的值。 若要了解如何应用包配置,请参阅 包配置SQL Server 2016 中 Integration Services 功能的行为更改

  • /Ser[ver] server:(可选)。 指定 /SQL/DTS 选项后,此选项可以指定从中检索包的服务器的名称。 如果省略 /Server 选项但指定 /SQL/DTS 选项,则尝试对本地服务器执行包。 server_instance 值可以用引号引起来。

    指定 /ISServer 选项时,必须指定 /Ser[ver] 选项。

  • /SQ[L] package_path:加载存储在 msdb 数据库的 SQL Server 中的包。 使用包部署模型部署存储在 msdb 数据库中的包。 若要使用项目部署模型运行部署到 Integration Services 服务器的包,请使用 /ISServer 选项。 有关包和项目部署模型的详细信息,请参阅 Deployment of Projects and Packages

  • 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 将失败。

  • /Su[m] :(可选)。 显示一个递增计数器,其中包含下一个组件将接收的行数。

  • /U[ser] user_name:(可选)。 允许检索受 SQL Server 身份验证保护的包。 仅当指定了 /SQL 选项时才使用此选项。 user_name 值可以用引号引起来。

    重要

    请尽可能使用 Windows 身份验证。

  • /Va[lidate] :(可选)。 在验证阶段之后停止执行包,而不实际运行包。 如果在验证期间使用 /WarnAsError 选项,则会导致 dtexec 将警告视为错误,因此使得包在验证期间出现警告时失败。

  • /VerifyB[uild] major[;minor[;build]]:(可选)。 根据验证阶段在 majorminorbuild 参数中指定的内部版本号,验证包的内部版本号。 如果出现不匹配,则将不执行包。

    这些值是长整数。 此参数可以使用以下三种格式之一,其中必须要有 major 的值:

    • major

    • major;minor

    • major; minor; build

  • /VerifyP[ackageID] packageID:(可选)。 通过将要执行的包的 GUID 与 package_id 参数中指定的值进行比较,来验证该 GUID。

  • /VerifyS[igned] :(可选)。 导致 Integration Services 检查包的数字签名。 如果包未签名或签名无效,则包将失败。 有关详细信息,请参阅 使用数字签名标识包的源

    重要

    在配置为检查包签名时, Integration Services 仅检查数字签名是否存在、是否有效以及是否来自可信来源。 Integration Services 不检查包是否已更改。

    备注

    可选的 BlockedSignatureStates 注册表值可指定比在 SQL Server Data Tools (SSDT) 中或 dtexec 命令行中设置的数字签名选项限制性更强的设置。 在这种情况下,限制性更强的注册表设置将覆盖其他设置。

  • /VerifyV[ersionID] versionID:(可选)。 通过将要执行的包的版本 GUID 与包验证阶段 version_id 参数中指定的值进行比较,来验证该 GUID。

  • /VLog [Filespec]:(可选)。 将所有 Integration Services 包事件写入设计包时已启用的日志提供程序。 若要让 Integration Services 启用文本文件的日志提供程序并将日志事件写入指定的文本文件,请将路径和文件名包括为 Filespec 参数。

    如果不包括 Filespec 参数,Integration Services 将不会为文本文件启用日志提供程序。 Integration Services 仅将日志事件写入设计包时已启用的日志提供程序。

  • /W[arnAsError] :(可选)。 导致包将警告视为错误,使得包在验证期间出现警告时失败。 如果验证期间无警告并且未指定 /Validate 选项,则执行包。

  • /X86:(可选)。 使 SQL Server 代理在 64 位计算机上以 32 位模式运行包。 满足下列条件时此选项由 SQL Server 代理设置:

    • 作业步骤类型为 “SQL Server Integration Services 包”

    • “新建作业步骤” 对话框中 “执行选项” 选项卡上的 “使用 32 位运行时” 选项处于选中状态。

    您也可通过使用存储过程或 SQL Server 管理对象 (SMO) 以编程方式创建此作业,从而为 SQL Server 代理作业步骤设置此选项。

    此选项仅由 SQL Server 代理使用。 如果在命令提示符下运行 dtexec 实用工具,则会忽略此选项。

备注

命令选项的指定顺序可以影响包的执行方式:

  • 选项的处理顺序与其在命令行中出现的顺序一致。 命令文件的读取顺序与其在命令行中出现的顺序一致。 命令文件中的命令的处理顺序也与其出现的顺序一致。

  • 如果在同一个命令行语句中多次出现相同的选项、参数或变量,则优先执行该选项的最后一个实例。

  • /Set/ConfigFile 选项将按其出现的顺序进行处理。

示例

下面的示例说明了如何使用 dtexec 命令提示实用工具配置和执行 SQL Server Integration Services 包。

“正在运行的包”

若要使用 Windows 身份验证执行保存到 SSIS 的 SQL Server 包,可使用以下代码:

dtexec /sq pkgOne /ser productionServer  

若要执行保存到 SSIS 包存储区的“文件系统”文件夹中的 SSIS 包,请使用以下代码:

dtexec /dts "\File System\MyPackage"  

若要验证使用 Windows 身份验证并保存在 SQL Server 中的包但不执行该包,可使用以下代码:

dtexec /sq pkgOne /ser productionServer /va  

若要执行保存在文件系统中的 SSIS 包,可使用以下代码:

dtexec /f "c:\pkgOne.dtsx"   

若要执行保存在文件系统中的 SSIS 包并指定日志选项,可使用以下代码:

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

若要执行使用 Windows 身份验证并保存至 SQL Server的默认本地实例的包,并在执行前查看其版本,可使用以下代码:

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

若要执行保存在文件系统中并在外部配置的 SSIS 包,可使用以下代码:

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

备注

如果路径或文件名包含空格,则 /SQL、/DTS 或 /FILE 选项的 package_pathfilespec 参数必须用引号引起来。 如果没有使用引号将参数引起来,则该参数不能包含空格。

日志记录选项

如果有三种日志项类型 A、B 和 C,以下不带参数的 ConsoleLog 选项可以显示所有三种日志类型和所有字段:

/CONSOLELOG  

以下选项显示所有日志类型,但只显示 Name 和 Message 列:

/CONSOLELOG NM  

以下选项仅显示日志项类型 A 的所有列:

/CONSOLELOG I;LogEntryTypeA  

以下选项仅显示日志项类型 A 的 Name 和 Message 列:

/CONSOLELOG NM;I;LogEntryTypeA  

以下选项显示日志项类型 A 和 B 的日志项:

/CONSOLELOG I;LogEntryTypeA;LogEntryTypeB  

可以使用多个 ConsoleLog 选项来获得相同的结果:

/CONSOLELOG I;LogEntryTypeA /CONSOLELOG I;LogEntryTypeB  

如果使用不带参数的 ConsoleLog 选项,将显示所有字段。 包含 list_options 参数会导致以下示例仅显示日志项类型 A 和所有字段:

/CONSOLELOG NM;I;LogEntryTypeA /CONSOLELOG  

以下示例可以显示除日志项类型 A 以外的所有日志项,即显示日志项类型 B 和 C:

/CONSOLELOG E;LogEntryTypeA  

以下示例使用了多个 ConsoleLog 选项和一个排除条件,但获得的结果是相同的:

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

以下示例不显示日志消息,因为一个日志文件类型同时出现在包含列表和排除列表中时,该类型将被排除。

/CONSOLELOG E;LogEntryTypeA /CONSOLELOG I;LogEntryTypeA  

SET 选项

以下示例显示如何使用 /SET 选项。从命令行启动包时,使用该选项可以更改任何包属性或变量的值。

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

项目选项

以下示例显示如何使用 /Project/Package 选项。

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

以下示例显示如何使用 /Project/Package 选项并设置包参数和项目参数。

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

ISServer 选项

以下示例显示如何使用 /ISServer 选项。

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

以下示例显示如何使用 /ISServer 选项并设置项目参数和连接管理器参数。

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