sp_apply_job_to_targets (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

Aplica un trabajo a uno o más servidores de destino, o a los servidores de destino que pertenecen a uno o más grupos de servidores de destino.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_apply_job_to_targets
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @target_server_groups = ] N'target_server_groups' ]
    [ , [ @target_servers = ] N'target_servers' ]
    [ , [ @operation = ] 'operation' ]
[ ; ]

Argumentos

[ @job_id = ] 'job_id'

Número de identificación del trabajo que se va a aplicar a los servidores o grupos de servidores de destino especificados. @job_id es uniqueidentifier, con un valor predeterminado de NULL.

Se deben especificar @job_id o @job_name , pero no se pueden especificar ambos.

[ @job_name = ] N'job_name'

Nombre del trabajo que se va a aplicar a los servidores de destino o grupos de servidores de destino asociados especificados. @job_name es sysname, con un valor predeterminado de NULL.

Se deben especificar @job_id o @job_name , pero no se pueden especificar ambos.

[ @target_server_groups = ] N'target_server_groups'

Lista separada por comas que contiene los grupos de servidores de destino a los que se va a aplicar el trabajo especificado. @target_server_groups es nvarchar(2048) con un valor predeterminado de NULL.

[ @target_servers = ] N'target_servers'

Lista separada por comas que contiene los servidores de destino a los que se va a aplicar el trabajo especificado. @target_servers es nvarchar(2048) con un valor predeterminado de NULL.

[ @operation = ] 'operation'

Especifica si el trabajo especificado se debe aplicar o quitar de los servidores de destino especificados o grupos de servidores de destino. @operation es varchar(7), con un valor predeterminado de APPLY. Las operaciones válidas son APPLY y REMOVE.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_apply_job_to_targets proporciona una manera sencilla de aplicar (o quitar) un trabajo de varios servidores de destino y es una alternativa a llamar sp_add_jobserver a (o sp_delete_jobserver) una vez para cada servidor de destino necesario.

Permisos

Este procedimiento almacenado es propiedad del rol db_owner . Puede conceder EXECUTE permisos para cualquier usuario, pero estos permisos se pueden invalidar durante una actualización de SQL Server.

Ejemplos

En el ejemplo siguiente se aplica el trabajo Backup Customer Information, creado anteriormente, a todos los servidores de destino del grupo Servers Maintaining Customer Information.

USE msdb;
GO

EXEC dbo.sp_apply_job_to_targets
    @job_name = N'Backup Customer Information',
    @target_server_groups = N'Servers Maintaining Customer Information',
    @operation = N'APPLY' ;
GO

Contenido relacionado