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 dtexec (utilidad).
|
|
/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 Usar puntos de comprobación en paquetes.
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 y Cambios del comportamiento en las características de Integration Services en SQL Server 2008..
|
|
/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 y Cambios del comportamiento en las características de Integration Services en SQL Server 2008..
|
|
/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.
|
|
/Dump
error 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.
Nota:
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.
Nota:
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 dtexec (utilidad).
|
|
/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 seguridad:
Siempre que sea posible, utilice la autenticación de Windows.
|
|
/Rem comment
|
(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.
|
|
/Set propertyPath;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 y Cambios del comportamiento en las características de Integration Services en SQL Server 2008..
|
|
/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 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 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 verificació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.
Importante:
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.
Nota:
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.
|