Tarea Transferir procedimientos almacenados principales

  • Artículo

Se aplica a:SQL Server SSIS Integration Runtime en Azure Data Factory

La tarea Transferir procedimientos almacenados principales transfiere uno o más procedimientos almacenados definidos por el usuario entre las bases de datos master en instancias de SQL Server. Para transferir un procedimiento almacenado de la base de datos master , el propietario del procedimiento debe ser dbo.

La tarea Transferir procedimientos almacenados principales se puede configurar para que transfiera todos los procedimientos almacenados o solo los procedimientos especificados. Esta tarea no copia procedimientos almacenados del sistema.

Es posible que los procedimientos almacenados principales que desea transferir ya existan en el destino. La tarea Transferir procedimientos almacenados principales se puede configurar para que haga lo siguiente con los procedimientos almacenados existentes:

  • Sobrescribir procedimientos almacenados existentes.

  • Hacer que la tarea genere un error cuando existan procedimientos almacenados duplicados.

  • Omitir los procedimientos almacenados duplicados.

Durante la ejecución, la tarea Transferir procedimientos almacenados principales se conecta a los servidores de origen y de destino a través de dos administradores de conexión SMO. Los administradores de conexión SMO se configuran independientemente de la tarea Transferir procedimientos almacenados principales y después se hace referencia a ellos en la tarea Transferir procedimientos almacenados principales. Los administradores de conexión SMO especifican el servidor y el modo de autenticación que se utilizará para tener acceso al servidor. Para más información, consulte SMO Connection Manager.

Transferir procedimientos almacenados entre instancias de SQL Server

La tarea Transferir procedimientos almacenados principales admite un origen y un destino que sea SQL Server .

Eventos

La tarea emite un evento de información que indica el número de procedimientos almacenados transferidos y un evento de advertencia cuando se sobrescribe un procedimiento almacenado.

La tarea Transferir procedimientos almacenados principales no indica el progreso incremental de la transferencia; 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 procedimientos almacenados transferidos. Si se asigna una variable definida por el usuario a la propiedad ExecValueVariable de la tarea Transferir procedimientos almacenados principales, se puede hacer que la información sobre la transferencia de procedimientos almacenados esté disponible para otros objetos del paquete. Para obtener más información, consulte Variables de Integration Services (SSIS) y Usar variables en paquetes.

Entradas del registro

La tarea Transferir procedimientos almacenados principales incluye las siguientes entradas del registro personalizadas:

  • TransferStoredProceduresTaskStartTransferringObjects Esta entrada del registro indica que se ha iniciado la transferencia. La entrada del registro incluye la hora de inicio.

  • TransferSStoredProceduresTaskFinishedTransferringObjects 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 procedimientos almacenados transferidos, y se escribe una entrada del registro para el evento OnWarning por cada procedimiento almacenado que se sobrescribe en el destino.

Seguridad y permisos

El usuario debe tener permisos para ver la lista de procedimientos almacenados de la base de datos master en el origen y debe ser miembro del rol de servidor sysadmin o tener permisos para crear procedimientos almacenados en la base de datos master del servidor de destino.

Configuración de la tarea Transferir procedimientos almacenados principales

Puede establecer propiedades a través del Diseñador de SSIS o mediante programación.

Para obtener 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:

Configurar la tarea Transferir procedimientos almacenados principales mediante programación

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 procedimientos almacenados principales (Página General)

Use la página General del cuadro de diálogo Editor de la tarea Transferir procedimientos almacenados principales para asignar un nombre a la tarea de transferencia de procedimientos almacenados master y describirla.

Nota:

Esta tarea transfiere solo los procedimientos almacenados definidos por el usuario que pertenecen a dbo desde una base de datos master del servidor de origen a una base de datos master del servidor de destino. A los usuarios se les debe conceder el permiso CREATE PROCEDURE en la base de datos maestra del servidor de destino o deben ser miembros del rol fijo del servidor sysadmin del servidor de destino para crear procedimientos almacenados en dicho servidor.

Opciones

Nombre
Escriba un nombre único para la tarea de transferencia de procedimientos almacenados principales. 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 de transferencia de procedimientos almacenados principales.

Editor de la tarea Transferir procedimientos almacenados principales (página Procedimientos almacenados)

Use la página Procedimientos almacenados del cuadro de diálogo Editor de la tarea Transferir procedimientos almacenados principales a fin de especificar las propiedades para copiar uno o más procedimientos definidos por el usuario desde la base de datos maestra en una instancia de la instancia de SQL Server a una base de datos maestra de otra instancia de SQL Server.

Nota:

Esta tarea transfiere solo los procedimientos almacenados definidos por el usuario que pertenecen a dbo desde una base de datos master del servidor de origen a una base de datos master del servidor de destino. A los usuarios se les debe conceder el permiso CREATE PROCEDURE en la base de datos maestra del servidor de destino o deben ser miembros del rol fijo del servidor sysadmin del servidor de destino para crear procedimientos almacenados en dicho servidor.

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 el modo en que la tarea debe controlar los procedimientos almacenados definidos por el usuario que tengan el mismo nombre que los que ya existen en la base de datos maestra del servidor de destino.

Esta propiedad presenta las opciones indicadas en la siguiente tabla:

Value Descripción
FailTask La tarea genera un error si ya existen procedimientos almacenados con el mismo nombre en la base de datos maestra del servidor de destino.
Sobrescribir La tarea sobrescribe los procedimientos almacenados con el mismo nombre en la base de datos maestra del servidor de destino.
Skip La tarea omite los procedimientos almacenados con el mismo nombre que ya existen en la base de datos maestra del servidor de destino.

TransferAllStoredProcedures
Seleccione esta opción si todos los procedimientos almacenados definidos por el usuario de la base de datos maestra del servidor de origen deben copiarse al servidor de destino.

Value Descripción
True Copie todos los procedimientos almacenados definidos por el usuario de la base de datos maestra .
False Copie solamente los procedimientos almacenados especificados.

StoredProceduresList
Seleccione los procedimientos almacenados definidos por el usuario de la base de datos maestra del servidor de origen que deben copiarse a la base de datos maestra de destino. Esta opción solo está disponible cuando TransferAllStoredProcedures se establece en False.

Consulte también

Tarea Transferir objetos de SQL Server
Tareas de Integration Services
Flujo de control