|
选项
|
说明
|
|---|
|
/?
[option_name]
|
(可选)。显示命令提示符选项,或显示指定的 option_name 的帮助,然后关闭实用工具。
如果指定 option_name 参数,则 dtexec 将启动 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
|
(可选)。指定在实用工具的命令选项确定阶段,打开 filespec 中指定的文件,并读取该文件中的选项,直到在文件中找到 EOF。filespec 是一个文本文件,它包含其他 dtexec 命令选项。filespec 参数指定与包执行关联的命令文件的文件名和路径。
|
|
/Conf[igFile] filespec
|
(可选)。指定要从中提取值的配置文件。使用该选项,可以设置一个与设计包时指定的配置不同的运行时配置。可以将不同的配置设置存储在 XML 配置文件中,然后在执行包之前使用 /ConfigFile 选项加载这些设置。
可以使用 /ConfigFile 选项在运行时加载在设计时未指定的其他配置。不过,不能使用 /ConfigFile 选项来替换在设计时也指定了的配置值。若要了解如何应用包配置,请参阅包配置和 SQL Server 2008 中 Integration Services 功能的行为更改。
|
|
/Conn[ection] id_or_name;connection_string [[;id_or_name;connection_string]…]
|
(可选)。指定带有指定名称或 GUID 的连接管理器位于包中,并指定了连接字符串。
该选项要求同时指定两个参数:必须在 id_or_name 参数中提供连接管理器名称或 GUID,并且在 connection_string 参数中指定有效的连接字符串。有关详细信息,请参阅 Integration Services 连接。
在运行时,可以使用 /Connection 选项从在设计时指定的位置之外的某个位置加载包配置。这些配置的值随后将替换最初指定的值。不过,可以将 /Connection 选项仅用于使用连接管理器的配置,如 SQL Server 配置。若要了解如何应用包配置,请参阅包配置和 SQL Server 2008 中 Integration Services 功能的行为更改。
|
|
/Cons[oleLog] [[displayoptions];[list_options;src_name_or_guid]...]
|
(可选)。在包执行过程中,在控制台显示指定的日志项。如果省略该选项,则不会在控制台中显示日志项。如果指定该选项时不带限制显示的参数,则会显示所有日志项。若要限制控制台显示的日志项,可以使用 displayoptions 参数指定要显示的列,并使用 list_options 参数限制日志项类型。
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 包存储区加载包。package_path 参数指定 SSIS 包的相对路径,从 SSIS 包存储区的根目录开始,包括 SSIS 包的名称。如果 package_path 参数中指定的路径或文件名包含空格,则必须在 package_path 参数两侧加上引号。
/DTS 选项不能与 /File 或 /SQL 选项一起使用。如果指定多个选项,dtexec 将失败。
|
|
/De[crypt]
password
|
(可选)。设置加载使用密码加密的包时所用的解密密码。
|
|
/Dump
error code
|
(可选)在包运行期间发生一个或多个指定事件时,创建调试转储文件 .mdmp 和 .tmp。error code 参数指定将触发系统创建调试转储文件的事件代码类型:错误、警告或信息。若要指定多个事件代码,请用分号 (;) 分隔每个 error code 参数。
默认情况下,Integration Services 将调试转储文件存储在 <驱动器>:\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 选项,系统将创建基于这两个设置的调试转储文件。
有关调试转储文件的详细信息,请参阅使用调试转储文件。
|
|
/DumpOnError
|
(可选)在包运行期间发生任意错误时,创建调试转储文件 .mdmp 和 .tmp。
默认情况下,Integration Services 将调试转储文件存储在 <驱动器>:\Program Files\Microsoft SQL Server\100\Shared\ErrorDumps 文件夹中。
注意:
调试转储文件可能包含敏感信息。使用访问控制列表 (ACL) 来限制对这些文件的访问,或将文件复制到具有受限访问权限的文件夹中。例如,在将调试文件发送给 Microsoft 支持服务部门之前,建议您删除所有敏感信息或机密信息。
若要将此选项应用到 dtexec 实用工具运行的所有包,请将 DumpOnError REG_DWORD 值添加到 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DtsPath 注册表项。DumpOnError REG_DWORD 值确定 /DumpOnError 选项是否需要与 dtexec 实用工具一起使用:
-
非零数据值指示出现任意错误时系统将创建调试转储文件,不论是否将 /DumpOnError 选项与 dtexec 实用工具一起使用。
-
零数据值指示,除非将 /DumpOnError 选项与 dtexec 实用工具一起使用,否则系统将不会创建调试转储文件。
有关调试转储文件的详细信息,请参阅使用调试转储文件。
|
|
/F[ile] filespec
|
(可选)。加载保存在文件系统中的包。filespec 参数指定包的路径和文件名。可以将路径指定为通用命名约定 (UNC) 路径或本地路径。如果 filespec 参数中指定的路径或文件名包含空格,则必须在 filespec 参数两侧加上引号。
/File 选项不能与 /DTS 或 /SQL 选项一起使用。如果指定多个选项,dtexec 将失败。
|
|
/H[elp] [option_name]
|
(可选)。显示选项的帮助,或显示指定的 option_name 的帮助,同时关闭实用工具。
如果指定 option_name 参数,则 dtexec 将启动 SQL Server 联机丛书并显示 dtexec 实用工具 主题。
|
|
/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 所允许的最大并发运行可执行文件数等于执行包的计算机上的处理器总数加二。
|
|
/P[assword] password
|
(可选)。允许检索受 SQL Server 身份验证保护的包。该选项与 /User 选项一起使用。如果省略 /Password 选项并使用 /User 选项,则使用空白密码。password 值可以用引号引起来。
安全说明:
请尽可能使用 Windows 身份验证。
|
|
/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 属性指定新值。各参数的含义如下:
Deny 将 CheckpointUsage 属性设置为 DTSCU_NEVER。
Force 将 CheckpointUsage 属性设置为 DTSCU_ALWAYS。
ifPossible 将 CheckpointUsage 属性设置为 DTSCU_IFEXISTS。
如果不指定值,则使用默认值 force。
|
|
/Set propertyPath;value
|
(可选)。覆盖包中变量、属性、容器、日志提供程序、Foreach 枚举器或连接的配置。使用此选项时,/Set 可将 propertyPath 参数更改为指定的值。可以指定多个 /Set 选项。
可以通过运行包配置向导确定 propertyPath 的值。选定项的路径会显示在最后一个“完成向导”页中,可以进行复制和粘贴。如果仅以此目的使用该向导,则可以在复制路径后取消它。
下面是执行包并为变量提供新值的示例:
dtexec /f mypackage.dtsx /set \package.variables[myvariable].Value;myvalue
可以使用 /Set 选项更改自其加载包配置的位置但是,不能使用 /Set 选项覆盖设计时的配置中所指定的值。若要了解如何应用包配置,请参阅包配置和 SQL Server 2008 中 Integration Services 功能的行为更改。
|
|
/Ser[ver] server
|
(可选)。指定了 /SQL 或 /DTS 选项时,此选项可以指定从中检索包的服务器的名称。如果省略 /Server 选项并指定 /SQL 或 /DTS 选项,则尝试对本地服务器执行包。server_instance 值可以用引号引起来。
|
|
/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 将失败。
|
|
/Su[m]
|
(可选)。显示一个递增计数器,其中包含下一个组件将接收的行数。
|
|
/U[ser] user_name
|
(可选)。允许检索受 SQL Server 身份验证保护的包。仅当指定了 /SQL 选项时才使用此选项。user_name 值可以用引号引起来。
安全说明:
请尽可能使用 Windows 身份验证。
|
|
/Va[lidate]
|
(可选)。在验证阶段之后停止执行包,而不实际运行包。如果在验证期间使用 /WarnAsError 选项,则会导致 dtexec 将警告视为错误,因此使得包在验证期间出现警告时失败。
|
|
/VerifyB[uild] major[;minor[;build]]
|
(可选)。根据验证阶段在 major、minor 和 build 参数中指定的内部版本号,验证包的内部版本号。如果出现不匹配,则将不执行包。
这些值是长整数。此参数可以使用以下三种格式之一,其中必须要有 major 的值:
-
major
-
major;minor
-
major; minor; build
|
|
/VerifyP[ackageID] packageID
|
(可选)。通过将要执行的包的 GUID 与 package_id 参数中指定的值进行比较,来验证该 GUID。
|
|
/VerifyS[igned]
|
(可选)。导致 Integration Services 检查包的数字签名。如果包未签名或签名无效,则包将失败。有关详细信息,请参阅对包进行数字签名。
重要提示:
在配置为检查包签名时,Integration Services 仅检查数字签名是否存在、是否有效以及是否来自可信来源。Integration Services 不检查包是否已更改。
注意:
可选的 BlockedSignatureStates 注册表值可指定比在 Business Intelligence Development Studio 中或 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 实用工具则会忽略此选项。
|