Partager via


sp_add_jobserver (Transact-SQL)

Transmet le travail spécifié au serveur spécifié.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sp_add_jobserver [ @job_id = ] job_id | [ @job_name = ] 'job_name'
     [ , [ @server_name = ] 'server' ] 

Arguments

  • [ @job_id =] job_id
    Numéro d'identification du travail. job_id est de type uniqueidentifier, avec une valeur par défaut NULL.

  • [ @job_name =] 'job_name'
    Nom du travail. L'argument job_name est de type sysname, avec NULL comme valeur par défaut.

    Notes

    Vous devez définir la valeur de job_id ou de job_name, mais pas les deux valeurs à la fois.

  • [ @server_name =] 'server'
    Nom du serveur vers lequel envoyer le travail. server est de type nvarchar(30), avec la valeur N'(LOCAL)' par défaut. L'argument serverpeut soit prendre la valeur (LOCAL) pour désigner un serveur local, soit prendre comme valeur le nom du serveur cible existant.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Jeux de résultats

Aucun

Notes

@automatic_post existe dans sp_add_jobserver mais n'est pas répertorié dans les arguments. @automatic_post est réservée à un usage interne.

SQL Server Management Studio est un outil dont l'interface graphique permet de gérer facilement les travaux. Son utilisation est recommandée pour créer et gérer l'infrastructure des travaux.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter cette procédure stockée. Les autres utilisateurs doivent disposer de l'un des rôles de base de données fixes SQL Server Agent suivants dans la base de données msdb.

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Pour en savoir plus sur les autorisations de ces rôles, consultez Rôles de base de données fixes de l'Agent SQL Server.

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter la procédure sp_add_jobserver pour des travaux multiserveurs.

Exemples

A. Affectation d'un travail au serveur local

L'exemple suivant affecte le travail NightlyBackups pour une exécution sur le serveur local.

Notes

Cet exemple suppose que le travail NightlyBackups existe déjà.

USE msdb ;
GO

EXEC dbo.sp_add_jobserver
    @job_name = N'NightlyBackups' ;
GO

B. Affectation d'un travail pour une exécution sur un serveur différent

L'exemple suivant affecte le travail multiserveurs Weekly Sales Backups au serveur SEATTLE2.

Notes

Dans l'exemple suivant, nous considérons que le travail Weekly Sales Backups existe déjà et que SEATTLE2 est inscrit en tant que serveur cible pour l'instance en cours.

USE msdb ;
GO

EXEC dbo.sp_add_jobserver
    @job_name = N'Weekly Sales Backups',
    @server_name = N'SEATTLE2' ;
GO