sp_apply_job_to_targets (Transact-SQL)

  • Article

S’applique à :SQL Server

Applique un travail à un ou plusieurs serveurs cibles ou aux serveurs cibles d'un ou de plusieurs groupes de serveurs cibles.

Conventions de la syntaxe Transact-SQL

Syntaxe

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' ]
[ ; ]

Arguments

[ @job_id = ] 'job_id'

Numéro d'identification du travail à appliquer aux serveurs ou groupes de serveurs cibles spécifiés. @job_id est uniqueidentifier, avec la valeur par défaut NULL.

Vous devez spécifier @job_id ou @job_name , mais les deux ne peuvent pas être spécifiées.

[ @job_name = ] N’job_name'

Nom du travail à appliquer aux serveurs ou groupes de serveurs cibles associés spécifiés. @job_name est sysname, avec la valeur par défaut NULL.

Vous devez spécifier @job_id ou @job_name , mais les deux ne peuvent pas être spécifiées.

[ @target_server_groups = ] N’target_server_groups'

Liste référençant, entre virgules, les groupes de serveurs cibles auxquels le travail spécifié est appliqué. @target_server_groups est nvarchar(2048), avec la valeur par défaut NULL.

[ @target_servers = ] N’target_servers'

Liste référençant, entre virgules, les serveurs cibles auxquels le travail spécifié est appliqué. @target_servers est nvarchar(2048), avec la valeur par défaut NULL.

[ @operation = ] 'operation'

Spécifie si le travail spécifié doit être appliqué ou supprimé des serveurs cibles ou des groupes de serveurs cibles spécifiés. @operation est varchar(7), avec la valeur par défaut APPLY. Les opérations valides sont APPLY et REMOVE.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

sp_apply_job_to_targets offre un moyen simple d’appliquer (ou de supprimer) un travail de plusieurs serveurs cibles et constitue une alternative à l’appel sp_add_jobserver (ou sp_delete_jobserver) une fois pour chaque serveur cible requis.

Autorisations

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.

Exemples

L'exemple suivant applique le travail Backup Customer Information créé précédemment à tous les serveurs cibles du groupe 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

Contenu connexe