Tarea Transferir mensajes de error
Se aplica a: SQL Server SSIS Integration Runtime en Azure Data Factory
La tarea Transferir mensajes de error transfiere uno o más mensajes de error definidos por el usuario de SQL Server entre instancias de SQL Server. Los mensajes definidos por el usuario son mensajes con un identificador igual o mayor que 50000. Los mensajes con un identificador menor que 50000 son mensajes de error del sistema, y no se pueden transferir mediante la tarea Transferir mensajes de error.
La tarea Transferir mensajes de error se puede configurar para que transfiera todos los mensajes de error o solo los mensajes de error especificados. Los mensajes de error definidos por el usuario pueden estar disponibles en distintos idiomas y la tarea se puede configurar para que transfiera únicamente los mensajes que estén en los idiomas seleccionados. Debe existir una versión en us_english del mensaje que utiliza página de códigos 1033 en el servidor de destino para poder transferir versiones en otros idiomas del mensaje a ese servidor.
La tabla sysmessages de la base de datos maestra contiene todos los mensajes de error, tanto los del sistema como los definidos por el usuario, que usa SQL Server.
Es posible que los mensajes definidos por el usuario que desea transferir ya existan en el destino. Un mensaje de error se define como un mensaje de error duplicado si el identificador y el idioma son iguales. La tarea Transferir mensajes de error se puede configurar para haga lo siguiente con los mensajes de error existentes:
Sobrescribir los mensajes de error existentes.
Hacer que la tarea genere un error cuando existan mensajes duplicados.
Omitir los mensajes de error duplicados.
Durante la ejecución, la tarea Transferir mensajes de error se conecta con los servidores de origen y de destino utilizando uno o dos administradores de conexión SMO. El administrador de conexiones SMO se configura independientemente de la tarea Transferir mensajes de error y después se hace referencia a él en la tarea Transferir mensajes de error. El administrador de conexiones SMO especifica el servidor y el modo de autenticación que se utiliza para tener acceso al servidor. Para más información, consulte SMO Connection Manager.
La tarea Transferir mensajes de error admite un origen y un destino que sea SQL Server . No hay restricciones respecto a qué versión hay que usar como origen o como destino.
Eventos
La tarea genera un evento de información que indica el número de mensajes de error transferidos.
La tarea Transferir mensajes de error no indica el progreso incremental de la transferencia de mensajes de error; solo indica 0% y 100%.
Valor de ejecución
El valor de ejecución, que se define en la propiedad ExecutionValue de la tarea, devuelve el número de mensajes de error transferidos. Si asigna una variable definida por el usuario a la propiedad ExecValueVariable de la tarea Transferir mensajes de error, puede hacer que la información de la transferencia del mensaje de error esté disponible para otros objetos del paquete. Para más información, vea Variables de Integration Services (SSIS) y Usar variables en paquetes.
Entradas del registro
La tarea Transferir mensajes de error incluye las siguientes entradas del registro personalizadas:
TransferErrorMessagesTaskStartTransferringObjects Esta entrada del registro indica que se ha iniciado la transferencia. La entrada del registro incluye la hora de inicio.
TransferErrorMessagesTaskFinishedTransferringObjects Esta entrada del registro indica que ha finalizado la transferencia. La entrada del registro incluye la hora de finalización.
Además, una entrada del registro para el evento OnInformation indica el número de mensajes de error transferidos, y se escribe una entrada del registro para el evento OnWarning event por cada mensaje de error que se sobrescribe en el destino.
Seguridad y permisos
Para crear mensajes de error, el usuario que ejecuta el paquete debe ser miembro de los roles sysadmin o serveradmin en el servidor de destino.
Configuración de la tarea Transferir mensajes de error
Puede establecer propiedades a través del Diseñador de SSIS o mediante programación.
Para obtener más información acerca de las propiedades que puede establecer en el Diseñador SSIS , haga clic en el tema siguiente:
Para obtener información sobre cómo establecer estas propiedades mediante programación, haga clic en el tema siguiente:
Related Tasks
Para obtener más información sobre cómo establecer estas propiedades en el Diseñador SSIS , haga clic en el siguiente tema:
Editor de la tarea Transferir mensajes de error (página General)
Utilice la página General del cuadro de diálogo Editor de la tarea Transferir mensajes de error para nombrar y describir la tarea Transferir mensajes de error. La tarea Transferir mensajes de error transfiere uno o más mensajes de error definidos por el usuario de SQL Server entre instancias de SQL Server.
Opciones
Nombre
Escriba un nombre único para la tarea Transferir mensajes de error. Este nombre se utiliza como etiqueta en el icono de tarea.
Nota
Los nombres de tarea deben ser únicos en un paquete.
Descripción
Escriba una descripción de la tarea Transferir mensajes de error.
Editor de la tarea Transferir mensajes de error (página Mensajes)
Use la página Mensajes del cuadro de diálogo Editor de la tarea Transferir mensajes de error para especificar propiedades para copiar uno o varios mensajes de error definidos por el usuario de SQL Server de una instancia de SQL Server a otra.
Opciones
SourceConnection
Seleccione un administrador de conexiones SMO de la lista, o bien haga clic en <Nueva conexión...> para crear una conexión al servidor de origen.
DestinationConnection
Seleccione un administrador de conexiones SMO de la lista o haga clic en <Nueva conexión…> para crear una conexión al servidor de destino.
IfObjectExists
Seleccione si la tarea debe sobrescribir mensajes de error definidos por el usuario existentes, omitir mensajes existentes o generar un error si existen ya mensajes de error con el mismo nombre en el servidor de destino.
TransferAllErrorMessages
Seleccione si la tarea debe copiar todos los mensajes definidos por el usuario o solo los especificados del servidor de origen al de destino.
Esta propiedad presenta las opciones indicadas en la siguiente tabla:
Value | Descripción |
---|---|
True | Copiar todos los mensajes definidos por el usuario. |
False | Copiar solo los mensajes definidos por el usuario especificados. |
ErrorMessagesList
Haga clic en el botón Examinar (…) para seleccionar los mensajes de error que quiera copiar.
Nota
Para poder seleccionar los mensajes de error que se van a copiar, debe especificar el parámetro SourceConnection .
ErrorMessageLanguagesList
Haga clic en el botón Examinar (…) para seleccionar los idiomas para los que se van a copiar mensajes de error definidos por el usuario al servidor de destino. Debe existir una versión en us_english (página de códigos 1033) del mensaje en el servidor de destino para poder transferir versiones en otros idiomas del mensaje a ese servidor.
Nota
Para poder seleccionar los mensajes de error que se van a copiar, debe especificar el parámetro SourceConnection .