Utilidad dtexec (Herramienta de SSIS)

La utilidad del símbolo del sistema dtexec se utiliza para configurar y ejecutar paquetes de SQL Server Integration Services. La utilidad dtexec proporciona acceso a todas las características de configuración y ejecución de paquetes, tales como conexiones, propiedades, variables, registro e indicadores de progreso. La utilidad dtexec permite cargar paquetes desde tres orígenes: una base de datos de Microsoft SQL Server, el servicio SSIS y el sistema de archivos.

Nota

Cuando se utiliza la versión de la utilidad dtexec que viene con SQL Server 2008 para ejecutar un paquete de SQL Server 2005 Integration Services (SSIS), Integration Services actualiza temporalmente el paquete a SQL Server 2008 Integration Services (SSIS). Sin embargo, no se puede usar la utilidad dtexec para guardar estos cambios actualizados. Para obtener más información sobre cómo actualizar de forma permanente un paquete de SQL Server 2005 a SQL Server 2008, vea Actualizar paquetes de Integration Services.

Consideraciones sobre la instalación de dtexec (Herramienta de SSIS) en equipos de 64 bits

En un equipo de 64 bits, Integration Services instala una versión de 64 bits de la utilidad dtexec (dtexec.exe). Si tiene que ejecutar ciertos paquetes en modo de 32 bits, tendrá que instalar la versión de 32 bits de la utilidad dtexec. Para instalar la versión de 32 bits de la utilidad dtexec, debe seleccionar Herramientas cliente o Business Intelligence Development Studio durante la instalación.

De forma predeterminada, si un equipo de 64 bits tiene instaladas tanto las versiones de 64 bits como las de 32 bits de una utilidad de líneas de comandos de Integration Services, ejecutará la versión de 32 bits en el símbolo del sistema. La versión de 32 bits se ejecuta porque la ruta de acceso del directorio para la versión de 32 bits aparece en la variable de entorno PATH antes que la ruta de acceso del directorio para la versión de 64 bits. (Normalmente, la ruta de acceso del directorio de 32 bits es <unidad>:\Archivos de programa(x86)\Microsoft SQL Server\100\DTS\Binn, mientras que la ruta de acceso del directorio de 64 bits es <unidad>:\Archivos de programa\Microsoft SQL Server\100\DTS\Binn.)

Nota

Si usa el Agente SQL Server para ejecutar la utilidad, el Agente SQL Server usa la versión de 64 bits de la utilidad automáticamente. El Agente SQL Server usa el Registro, no la variable de entorno PATH, para buscar la aplicación ejecutable correcta para la utilidad.

Para garantizar que se ejecuta la versión de 64 bits de la utilidad en el símbolo del sistema, puede realizar una de las siguientes acciones:

  • Abra una ventana del símbolo del sistema, cambie al directorio que contiene la versión de 64 bits de la utilidad (<unidad>:\Archivos de programa\Microsoft SQL Server\100\DTS\Binn) y, a continuación, ejecute la utilidad desde esa ubicación.

  • En el símbolo del sistema, ejecute la utilidad escribiendo la ruta de acceso completa (<unidad>: \Archivos de programa\Microsoft SQL Server\100\DTS\Binn) para la versión de 64 bits de la utilidad.

  • Cambie de forma permanente el orden de las rutas de acceso en la variable de entorno PATH situando en la variable la ruta de acceso de 64 bits (<unidad>:\Archivos de programa\Microsoft SQL Server\100\DTS\Binn) antes que la ruta de acceso de 32 bits (<unidad>:\Archivos de programa(x86)\Microsoft SQL Server\100\DTS\Binn).

dtexec (Herramienta de SSIS): fases de ejecución

La utilidad tiene cuatro fases por las que pasa durante su ejecución. Las fases son las siguientes:

  1. Fase de origen de comandos: el símbolo del sistema lee la lista de opciones y argumentos que se han especificado. Todas las fases siguientes se omiten si se encuentra una opción /? o /HELP.

  2. Fase de carga del paquete: se carga el paquete especificado por la opción /SQL, /FILE o /DTS.

  3. Fase de configuración: las opciones se procesan en el orden indicado a continuación:

    • Opciones que establecen variables, propiedades y marcas de paquetes.

    • Opciones que comprueban la versión y la compilación del paquete.

    • Opciones que configuran el comportamiento de tiempo de ejecución de la utilidad, como la creación de informes.

  4. Fase de ejecución y validación: el paquete se ejecuta o se valida sin ejecutarse si se ha especificado la opción /VALIDATE.

dtexec (Herramienta de SSIS): códigos de salida devueltos

Cuando se ejecuta un paquete, dtexec puede devolver un código de salida. El código de salida se utiliza para rellenar la variable ERRORLEVEL, cuyo valor se puede probar en instrucciones condicionales o lógica de bifurcaciones en un archivo por lotes. La siguiente tabla enumera los valores que la utilidad dtexec puede establecer al salir.

Valor

Descripción

0

El paquete se ejecutó correctamente.

1

Se produjo un error en el paquete.

3

El usuario canceló el paquete.

4

La utilidad no pudo localizar el paquete solicitado. No se pudo encontrar el paquete.

5

La utilidad no pudo cargar el paquete solicitado. No se pudo cargar el paquete.

6

La utilidad encontró un error interno semántico o sintáctico en la línea de comandos.

dtexec (Herramienta de SSIS): reglas de sintaxis

Todas las opciones deben comenzar con una barra diagonal (/) o un signo menos (-). Las opciones que se muestran aquí empiezan con una barra diagonal (/), aunque se puede sustituir por el signo menos (-).

Si el argumento contiene un espacio, debe ir entre comillas. Si el argumento no está entre comillas, no podrá contener espacios en blanco.

Las dobles comillas dentro de cadenas entre comillas representan comillas simples de escape.

Las opciones y los argumentos, excepto las contraseñas, no distinguen entre mayúsculas y minúsculas.

Usar dtexec (Herramienta de SSIS) desde xp_cmdshell

Puede ejecutar dtexec desde el símbolo del sistema xp_cmdshell. En el siguiente ejemplo se muestra cómo ejecutar un paquete denominado UpsertData.dtsx y pasar por alto el código de retorno:

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

En el siguiente ejemplo se muestra cómo ejecutar el mismo paquete y capturar el código de retorno:

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

En Microsoft SQL Server, la opción xp_cmdshell se deshabilita de forma predeterminada en las instalaciones nuevas. La opción puede habilitarse ejecutando el procedimiento almacenado del sistema sp_configure. Para obtener más información, vea xp_cmdshell (opción).

Sintaxis

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

Parámetros

Para entender la correspondencia entre las opciones del símbolo del sistema utilizadas con la utilidad dtsrun de SQL Server 2000 y las opciones del símbolo del sistema empleadas con la utilidad dtexec de SQL Server, vea Hacer corresponder las opciones de dtsrun y de dtexec.

Opción

Descripción

/? [option_name]

(Opcional) Muestra las opciones del símbolo del sistema o proporciona ayuda para el argumento option_name especificado y, a continuación, cierra la utilidad.

Si especifica un argumento option_name, dtexec abre los Libros en pantalla de SQL Server y muestra el tema Utilidad dtexec (Herramienta de SSIS).

/CheckF[ile]filespec

(Opcional) Establece la propiedad CheckpointFileName del paquete en la ruta de acceso y el archivo especificados en filespec. Este archivo se utiliza cuando se reinicia el paquete. Si se especifica esta opción y no se proporciona ningún valor para el nombre de archivo, el valor de CheckpointFileName para el paquete se establece en una cadena vacía. Si no se especifica esta opción, los valores del paquete se conservan.

/CheckP[ointing]{on\off}

(Opcional) Establece un valor que determina si el paquete utiliza puntos de comprobación durante su ejecución. El valor on especifica que un paquete que haya devuelto un error debe volver a ejecutarse. Cuando se vuelve a ejecutar el paquete que ha devuelto el error, el motor en tiempo de ejecución utiliza el archivo de punto de comprobación para reiniciar el paquete desde el punto de error.

El valor predeterminado es on si la opción se declara sin un valor. La ejecución del paquete devolverá errores si el valor se establece en on y no se encuentra el archivo de punto de comprobación. Si no se especifica esta opción, se conserva el valor establecido en el paquete. Para obtener más información, vea Reiniciar paquetes con errores mediante puntos de comprobación.

La opción /CheckPointing on de dtexec equivale a establecer en True el valor de la propiedad SaveCheckpoints del paquete y el de la propiedad CheckpointUsage en Always.

/Com[mandFile]filespec

(Opcional) Especifica que, durante la fase de origen de comandos de la utilidad, el archivo especificado en filespec se abre y las opciones del archivo se leen hasta que se encuentra EOF en dicho archivo. filespec es un archivo de texto que contiene opciones de comando dtexec adicionales. El argumento filespec especifica el nombre y la ruta del archivo de comandos que se debe asociar con la ejecución del paquete.

/Conf[igFile]filespec

(Opcional) Especifica un archivo de configuración del que se extraerán valores. Si utiliza esta opción, puede establecer una configuración en tiempo de ejecución que difiera de la configuración especificada para el paquete durante el diseño. Puede almacenar parámetros de configuración diferentes en un archivo de configuración XML y después cargar los parámetros mediante la opción /ConfigFile antes de la ejecución del paquete.

Puede utilizar la opción /ConfigFile para cargar configuraciones adicionales en tiempo de ejecución que no especificó en tiempo de diseño. Sin embargo, no puede utilizar la opción /ConfigFile para reemplazar los valores configurados que también especificó en tiempo de diseño. Para entender cómo se aplican las configuraciones de paquete, vea Configuraciones de paquetes de SSIS y Cambios de comportamiento en las características de Integration Services en SQL Server 2008 R2.

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

(Opcional). Especifica que el administrador de conexiones con el nombre o el GUID especificado se encuentra en el paquete, y especifica una cadena de conexión.

Esta opción requiere que se especifiquen ambos parámetros: el nombre del administrador de conexiones o el GUID deben proporcionarse en el argumento id_or_name y se debe especificar una cadena de conexión válida en el argumento connection_string. Para obtener más información, vea Conexiones de Integration Services.

En tiempo de ejecución puede utilizar la opción /Connection para cargar las configuraciones de paquete desde una ubicación distinta de la que especificó en tiempo de diseño. A continuación, los valores de estas configuraciones reemplazan a los que se especificaron originalmente. Sin embargo, solo puede utilizar la opción /Connection para las configuraciones, por ejemplo las de SQL Server, que usen un administrador de conexiones. Para entender cómo se aplican las configuraciones de paquete, vea Configuraciones de paquetes de SSIS y Cambios de comportamiento en las características de Integration Services en SQL Server 2008 R2.

/Cons[oleLog] [[displayoptions];[list_options;src_name_or_guid]...]

(Opcional). Muestra las entradas de registro especificadas en la consola durante la ejecución del paquete. Si se omite esta opción, no se muestran entradas de registro en la consola. Si se especifica la opción sin parámetros que limiten la visualización, se muestran todas las entradas del registro. Para limitar las entradas que se muestran en la consola, puede especificar las columnas que se mostrarán mediante el parámetro displayoptions y limitar los tipos de entrada de registro mediante el parámetro list_options.

Éstos son los valores de displayoptions:

  • N (Nombre)

  • C (Equipo)

  • O (Operador)

  • S (Nombre de origen)

  • G (GUID de origen)

  • X (GUID de ejecución)

  • M (Mensaje)

  • T (Hora de inicio y de finalización)

Éstos son los valores de list_options:

  • I: especifica la lista de inclusión. Solo se registran los nombres de origen o GUID que se especifican.

  • E: especifica la lista de exclusión. No se registran los nombres de origen o GUID que se especifican.

  • El parámetro src_name_or_guid especificado para la inclusión o exclusión es un nombre de evento, nombre de origen o GUID de origen.

Si utiliza varias opciones /ConsoleLog en el mismo símbolo del sistema, éstas interactúan de la siguiente manera:

  • Su orden de aparición no tiene ningún efecto.

  • Si no hay listas de inclusión presentes en la línea de comandos, las listas de exclusión se aplican a todos los tipos de entradas de registro.

  • Si hay cualquier lista de inclusión presente en la línea de comandos, las listas de exclusión se aplican sobre la unión de todas las listas de inclusión.

Para obtener varios ejemplos de la opción /ConsoleLog, vea la sección Notas.

/D[ts]package_path

(Opcional) Carga un paquete desde el Almacén de paquetes SSIS. El argumento package_path especifica la ruta relativa al paquete SSIS, empezando en la raíz del Almacén de paquetes SSIS, e incluye el nombre del paquete SSIS. Si la ruta de acceso o el nombre de archivo especificado en el argumento package_path contiene un espacio, debe escribir el argumento package_path entre comillas.

La opción /DTS no se puede usar junto con la opción /File o /SQL. Si se especifican varias opciones, dtexec devuelve un error.

/De[crypt] password

(Opcional) Establece la contraseña de descifrado que se utiliza cuando se carga un paquete con cifrado de contraseña.

/Dumperror code

(Opcional) Crea los archivos de volcado de depuración, .mdmp y .tmp, cuando se producen uno o varios de los eventos especificados mientras el paquete está ejecutándose. El argumento error code especifica el tipo de código de evento (error, advertencia o información) que activará el sistema para crear los archivos de volcado de depuración. Para especificar varios códigos de evento, separe cada argumento error code con un punto y coma (;).

De forma predeterminada, Integration Services almacena los archivos de volcado de depuración en la carpeta <unidad>:\Archivos de programa\Microsoft SQL Server\100\Shared\ErrorDumps.

NotaNota
Los archivos de volcado de depuración pueden contener información confidencial. Utilice una lista de control de acceso (ACL) para restringir el acceso a los archivos, o cópielos en una carpeta con acceso restringido. Por ejemplo, antes de enviar los archivos de depuración a los servicios de soporte técnico de Microsoft, se recomienda quitar la información importante o confidencial.

Para aplicar esta opción a todos los paquetes que ejecuta la utilidad dtexec, agregue un valor REG_SZ de DumpOnCodes a la clave del Registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DtsPath. El valor de datos de DumpOnCodes especifica el código o códigos de error que activarán el sistema para crear los archivos de volcado de depuración. Varios códigos de error deben separarse mediante un punto y coma (;).

Si agrega un valor de DumpOnCodes a la clave del Registro y utiliza la opción /Dump, el sistema creará archivos de volcado de depuración que se basen en ambos valores.

Para obtener más información sobre los archivos de volcado de depuración, vea Trabajar con archivos de volcado de depuración.

/DumpOnError

(Opcional) Crea los archivos de volcado de depuración, .mdmp y .tmp, cuando se produce un error mientras el paquete se está ejecutando.

De forma predeterminada, Integration Services almacena los archivos de volcado de depuración en la carpeta <unidad>:\Archivos de programa\Microsoft SQL Server\100\Shared\ErrorDumps.

NotaNota
Los archivos de volcado de depuración pueden contener información confidencial. Utilice una lista de control de acceso (ACL) para restringir el acceso a los archivos, o cópielos en una carpeta con acceso restringido. Por ejemplo, antes de enviar los archivos de depuración a los servicios de soporte técnico de Microsoft, se recomienda quitar la información importante o confidencial.

Para aplicar esta opción a todos los paquetes que ejecuta la utilidad dtexec, agregue un valor REG_DWORD de DumpOnError a la clave del Registro HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DtsPath. El valor REG_DWORD de DumpOnError determina si hay que usar la opción /DumpOnError con la utilidad dtexec:

  • Un valor de datos distinto de cero indica que el sistema creará los archivos de volcado de depuración cuando se produzca algún error, independientemente de si se utiliza la opción /DumpOnError con la utilidad dtexec.

  • El valor cero indica que el sistema no creará los archivos de volcado de depuración, a menos que se use la opción /DumpOnError con la utilidad dtexec.

Para obtener más información sobre los archivos de volcado de depuración, vea Trabajar con archivos de volcado de depuración.

/F[ile]filespec

(Opcional) Carga un paquete que se guarda en el sistema de archivos. El argumento filespec especifica la ruta y el nombre de archivo del paquete. Puede especificar la ruta como una ruta UNC (Convención de nomenclatura universal) o como una ruta local. Si la ruta de acceso o el nombre de archivo especificado en el argumento filespec contiene un espacio, debe escribir el argumento filespec entre comillas.

La opción /File no se puede usar junto con la opción /DTS o /SQL. Si se especifican varias opciones, dtexec devuelve un error.

/H[elp] [option_name]

(Opcional) Muestra ayuda para las opciones o para el argumento option_name especificado y cierra la utilidad.

Si especifica un argumento option_name, dtexec abre los Libros en pantalla de SQL Server y muestra el tema Utilidad dtexec (Herramienta de SSIS).

/L[ogger]classid_orprogid;configstring

(Opcional) Asocia uno o más proveedores de registro con la ejecución de un paquete SSIS. El parámetro classid_orprogid especifica el proveedor de registro y puede especificarse como GUID de clase. configstring es la cadena que se utiliza para configurar el proveedor de registro.

La siguiente lista muestra los proveedores de registro disponibles:

  • Archivo de texto:

    • 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}

  • Registro de eventos de Windows:

    • ProgID: DTS.LogProviderEventLog.1

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

  • Archivo XML:

    • ProgID: DTS.LogProviderXMLFile.1

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

/M[axConcurrent]concurrent_executables

(Opcional) Especifica el número de archivos ejecutables que el paquete puede ejecutar simultáneamente. El valor especificado debe ser un valor entero no negativo ó -1. El valor -1 significa que SSIS permitirá la ejecución simultánea de un número máximo de archivos que sea igual al número total de procesadores del equipo que ejecuta el paquete más dos.

/P[assword]password

(Opcional) Permite la recuperación de un paquete protegido por la autenticación de SQL Server. Esta opción se utiliza junto con la opción /User. Si se omite la opción /Password y se utiliza la opción /User, se utiliza una contraseña en blanco. El valor de password puede entrecomillarse.

Nota de seguridadNota de seguridad
Siempre que sea posible, utilice la autenticación de Windows.

/Remcomment

(Opcional) Incluye comentarios en el símbolo del sistema o en los archivos de comandos. El argumento es opcional. El valor de comment es una cadena que debe incluirse entre comillas o no debe contener ningún espacio en blanco. Si no se especifica ningún argumento, se inserta una línea en blanco. Los valores de comment se descartan durante la fase de origen de comandos.

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

(Opcional) Especifica el tipo de mensajes que se notificarán. Las opciones de informes disponibles para level son las siguientes:

N    Sin informes.

E    Se notifican los errores.

W    Se notifican las advertencias.

I    Se notifican los mensajes informativos.

C    Se notifican los eventos personalizados.

D    Se notifican los eventos de la tarea Flujo de datos.

P    Se notifica el progreso.

V    Informes detallados.

Los argumentos V y N se excluyen mutuamente con los otros argumentos, por lo que deben especificarse solos. Si no se especifica la opción /Reporting, el nivel predeterminado es E (errores), W (advertencias) y P (progreso).

Todos los eventos van precedidos de una marca de tiempo en el formato "AA/MM/DD HH:MM:SS" y un GUID o nombre descriptivo si está disponible.

El parámetro opcional event_guid_or_name es una lista de excepciones para los proveedores de registro. La excepción especifica los eventos que no se registran pero que podrían haberse registrado.

No es necesario excluir un evento si éste no se registra habitualmente de forma predeterminada.

/Res[tart] {deny | force | ifPossible}

(Opcional) Especifica un nuevo valor para la propiedad CheckpointUsage del paquete. El significado de los parámetros es el siguiente:

Deny   Establece la propiedad CheckpointUsage en DTSCU_NEVER.

Force   Establece la propiedad CheckpointUsage en DTSCU_ALWAYS.

ifPossible   Establece la propiedad CheckpointUsage en DTSCU_IFEXISTS.

Si no se especifica ningún valor, se utiliza el valor predeterminado de force.

/SetpropertyPath;value

(Opcional) Invalida la configuración de una variable, propiedad, contenedor, proveedor de registro, enumerador Foreach o conexión en un paquete. Cuando se utiliza esta opción, /Set cambia el argumento propertyPath al valor especificado. Se pueden especificar varias opciones /Set.

Puede ejecutar el Asistente para la configuración de paquetes con el objeto de determinar el valor de propertyPath. Las rutas de los elementos que seleccione se muestran en la página Finalización del asistente y se pueden copiar y pegar. Si ha utilizado el asistente exclusivamente con este fin, puede cancelarlo después de copiar las rutas de acceso.

A continuación, se muestra un ejemplo de ejecución de un paquete y de suministro de un nuevo valor para una variable.

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

Puede utilizar la opción /Set para cambiar la ubicación desde la que se cargan las configuraciones de paquete. Sin embargo, no puede utilizar la opción /Set para invalidar un valor que se especificó en una configuración en tiempo de diseño. Para entender cómo se aplican las configuraciones de paquete, vea Configuraciones de paquetes de SSIS y Cambios de comportamiento en las características de Integration Services en SQL Server 2008 R2.

/Ser[ver]server

(Opcional). Se utiliza cuando se especifica la opción /SQL o /DTS, y especifica el nombre del servidor del que se recupera el paquete. Si omite la opción /Server y se especifica la opción /SQL o /DTS, se intenta le ejecución del paquete sobre un servidor local. El valor de server_instance puede entrecomillarse.

/SQ[L]package_path

Carga un paquete que se almacena en SQL Server. El argumento package_path especifica el nombre del paquete que se recuperará. Si las carpetas se incluyen en la ruta, finalizan con barras diagonales inversas ("\"). El valor de package_path puede entrecomillarse. Si la ruta de acceso o el nombre de archivo especificado en el argumento package_path contiene un espacio, debe escribir el argumento package_path entre comillas.

Puede usar las opciones /User, /Password y /Server junto con la opción /SQL.

Si omite la opción /User, se utiliza la autenticación de Windows para tener acceso al paquete. Si utiliza la opción /User, el nombre de inicio de sesión /User especificado se asocia con la autenticación de SQL Server.

La opción /Password se utiliza junto con la opción /User. Si utiliza la opción /Password, se tiene acceso al paquete con la información de nombre de usuario y contraseña que se ha proporcionado. Si omite la opción /Password, se utiliza una contraseña en blanco.

Nota de seguridadNota de seguridad
Siempre que sea posible, utilice la autenticación de Windows.

Si se omite la opción /Server, se asume la instancia local predeterminada de SQL Server.

La opción /SQL no se puede usar junto con la opción /DTS o /File. Si se especifican varias opciones, dtexec devuelve un error.

/Su[m]

(Opcional) Muestra un contador incremental que contiene el número de filas que recibirá el siguiente componente.

/U[ser]user_name

(Opcional) Permite la recuperación de un paquete protegido por la autenticación de SQL Server. Esta opción se utiliza solo cuando se especifica la opción /SQL. El valor de user_name puede entrecomillarse.

Nota de seguridadNota de seguridad
Siempre que sea posible, utilice la autenticación de Windows.

/Va[lidate]

(Opcional) Detiene la ejecución del paquete después de la fase de validación sin ejecutar realmente el paquete. Durante la validación, el uso de la opción /WarnAsError hace que dtexec trate una advertencia como un error; por consiguiente, el paquete devuelve un error cuando se produce una advertencia durante la validación.

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

(Opcional) Comprueba el número de compilación de un paquete con los números de compilación que se especificaron durante la fase de comprobación en los argumentos major, minor y build. Si se produce una discrepancia, el paquete no se ejecuta.

Los valores son enteros largos. El argumento puede tener una de las tres formas, con un valor para major siempre obligatorio:

  • major

  • major;minor

  • major; minor; build

/VerifyP[ackageID]packageID

(Opcional) Comprueba el GUID del paquete que se ejecutará al compararlo con el valor especificado en el argumento package_id.

/VerifyS[igned]

(Opcional) Hace que Integration Services compruebe la firma digital del paquete. Si el paquete no está firmado o la firma no es válida, se produce un error en el paquete. Para obtener más información, vea Utilizar firmas digitales con los paquetes.

Nota importanteImportante
Cuando se configura Integration Services para comprobar la firma del paquete, solo comprueba si la firma digital está presente, es válida y procede de un origen de confianza. Integration Services no comprueba si se ha cambiado el paquete.
NotaNota
El valor del Registro BlockedSignatureStates opcional puede especificar un valor de configuración más restrictivo que la opción de firma digital establecida en Business Intelligence Development Studio o en la línea de comandos de dtexec. En esta situación, el valor del Registro más restrictivo invalida los demás valores.

/VerifyV[ersionID]versionID

(Opcional) Comprueba el GUID de versión de un paquete que se ejecutará al compararlo con el valor especificado en el argumento version_id durante la fase de validación del paquete.

/VLog[Filespec]

(Opcional). Escribe todos los eventos de paquete de Integration Services para los proveedores de registro que estaban habilitados cuando se diseñó el paquete. Para hacer que Integration Services habilite un proveedor de registro para los archivos de texto y escriba eventos de registro en un archivo de texto especificado, incluya una ruta de acceso y un nombre de archivo como parámetro Filespec.

Si no incluye el parámetro Filespec, Integration Services no habilitará un proveedor de registro para los archivos de texto. Integration Services solo escribirá eventos de registro para los proveedores de registro que estaban habilitados cuando se diseñó el paquete.

/W[arnAsError]

(Opcional) Hace que el paquete considere una advertencia como un error y que, por consiguiente, el paquete devuelva un error si se produce una advertencia durante la validación. Si no se produce advertencia durante la validación y no se especifica la opción /Validate, se ejecuta el paquete.

/X86

(Opcional). Hace que el Agente SQL Server ejecute el paquete en modo de 32 bits en un equipo de 64 bits. Esta opción la establece el Agente SQL Server cuando se cumplen las condiciones:

  • El tipo de paso de trabajo es Paquete SQL Server Integration Services.

  • La opción Usar motor de tiempo de ejecución de 32 bits en la ficha Opciones de ejecución del cuadro de diálogo Nuevo paso de trabajo está seleccionada.

También puede establecer esta opción para un paso de trabajo del Agente SQL Server utilizando procedimientos almacenados u Objetos de administración de SQL Server (SMO) para crear el trabajo mediante programación. 

Esta opción solo la utiliza el Agente SQL Server y se omite si se ejecuta la utilidad dtexec en el símbolo del sistema.

Comentarios

El orden en el que se especifican las opciones de comandos puede influir en la forma en que se ejecuta el paquete:

  • Las opciones se procesan en el orden en el que se encuentran en la línea de comandos. Los archivos de comandos se leen en el orden en que se encuentran en la línea de comandos. Los comandos del archivo de comandos también se procesan en el orden en que se encuentran.

  • Si la misma opción, parámetro o variable aparece en la misma instrucción de línea de comandos más de una vez, tiene prioridad la última instancia de la opción.

  • Las opciones /Set y /ConfigFile se procesan en el orden en el que se encuentran.

dtexec (Herramienta de SSIS): ejemplos

Ejecutar paquetes SSIS

Para ejecutar un paquete SSIS guardado en SQL Server utilizando la autenticación de Windows, utilice el siguiente código:

dtexec /sq pkgOne /ser productionServer

Para ejecutar un paquete SSIS guardado en la carpeta Sistema de archivos en el almacén de paquetes SSIS, utilice el siguiente código:

dtexec /dts "\File System\MyPackage"

Para validar un paquete que utiliza la autenticación de Windows y se guarda en SQL Server sin ejecutar el paquete, utilice el siguiente código:

dtexec /sq pkgOne /ser productionServer /va

Para ejecutar un paquete SSIS que se guarda en el sistema de archivos, utilice el siguiente código:

dtexec /f "c:\pkgOne.dtsx" 

Para ejecutar un paquete SSIS que se guarda en el sistema de archivos y especificar opciones de registro, utilice el siguiente código:

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

Para ejecutar un paquete que utiliza la autenticación de Windows y se guarda en la instancia local predeterminada de SQL Server, y comprobar la versión antes de que se ejecute, utilice el siguiente código:

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

Para ejecutar un paquete SSIS que se guarda en el sistema de archivos y que se ha configurado externamente, utilice el siguiente código:

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

Nota

Los argumentos package_path o filespec de las opciones /SQL, /DTS o /FILE deben ir entre comillas siempre que la ruta o el nombre del archivo contenga un espacio en blanco. Si el argumento no está entre comillas, no podrá contener espacios en blanco.

Opción de registro

Si hay tres tipos de entrada de registro, A, B y C, la siguiente opción ConsoleLog sin un parámetro muestra los tres tipos de registro con todos los campos:

/CONSOLELOG

La siguiente opción muestra todos los tipos de registro, pero solo con las columnas Name y Message:

/CONSOLELOG NM

La siguiente opción muestra todas las columnas, pero solo para el tipo de entrada de registro A:

/CONSOLELOG I;LogEntryTypeA

La siguiente opción solo muestra el tipo de entrada de registro A con las columnas Name y Message:

/CONSOLELOG NM;I;LogEntryTypeA

La siguiente opción muestra las entradas del tipo de entrada de registro A y B:

/CONSOLELOG I;LogEntryTypeA;LogEntryTypeB

Puede lograr los mismos resultados mediante varias opciones de ConsoleLog:

/CONSOLELOG I;LogEntryTypeA /CONSOLELOG I;LogEntryTypeB

Si se utiliza la opción ConsoleLog sin parámetros, se muestran todos los campos. La inclusión de un parámetro de list_options hace que se muestre solo el tipo de entrada de registro A con todos los campos:

/CONSOLELOG NM;I;LogEntryTypeA /CONSOLELOG

La siguiente opción muestra todas las entradas de registro excepto el tipo de entrada de registro A, lo que significa que se muestran los tipos de entrada de registro B y C:

/CONSOLELOG E;LogEntryTypeA

El siguiente ejemplo obtiene los mismos resultados utilizando varias opciones ConsoleLog y una única exclusión:

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

El siguiente ejemplo no muestra mensajes de registro, porque, cuando un tipo de archivo de registro figura tanto en la lista de exclusiones como en la de inclusiones, éste se excluye.

/CONSOLELOG E;LogEntryTypeA /CONSOLELOG I;LogEntryTypeA

Opción SET

A continuación se muestra cómo utilizar la opción /SET, que permite cambiar el valor de cualquier propiedad o variable de paquete al iniciar el paquete desde la línea de comandos.

/SET \package\DataFlowTask.Variables[User::MyVariable].Value;newValue
Icono de Integration Services (pequeño) Manténgase al día con Integration Services

Para obtener las descargas, artículos, ejemplos y vídeos más recientes de Microsoft, así como soluciones seleccionadas de la comunidad, visite la página de Integration Services en MSDN:


Para recibir notificaciones automáticas de estas actualizaciones, suscríbase a las fuentes RSS disponibles en la página.