sp_addqreader_agent (Transact-SQL)

Ajoute un Agent de lecture de la file d'attente à un serveur de distribution. Cette procédure stockée est exécutée sur la base de données de distribution du serveur de distribution ou sur la base de publication du serveur de publication.

Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_addqreader_agent [ @job_login = ] 'job_login' 
        , [ @job_password = ] 'job_password'
    [ , [ @job_name = ] 'job_name'
    [ , [ @frompublisher = ] frompublisher

Arguments

• [ @job_login= ] 'job_login'
  Nom de connexion du compte Microsoft Windows sous lequel l'Agent s'exécute. job_login est de type nvarchar(257), sans valeur par défaut. Ce compte Windows est toujours utilisé pour les connexions des agents au serveur de distribution.

• [ @job_password= ] 'job_password'
  Mot de passe du compte Windows sous lequel l'Agent s'exécute. job_password est de type sysname, sans valeur par défaut.

  Remarque relative à la sécurité
  Ne stockez pas les informations d'authentification dans des fichiers de script. Pour une sécurité optimale, les noms de connexion et les mots de passe doivent être fournis au moment de l'exécution.

• [ @job_name= ] 'job_name'
  Nom d'un travail de l'agent existant. job_name est de type sysname, avec NULL comme valeur par défaut. Ce paramètre n'est spécifié que lorsque l'Agent est créé avec un travail existant au lieu d'un nouveau travail (valeur par défaut).

• [ @frompublisher= ] frompublisher
  Spécifie si la procédure est exécutée sur le serveur de publication. frompublisher est de type bit, avec 0 comme valeur par défaut. La valeur 1 signifie que la procédure est exécutée sur la base de données de publication du serveur de publication.

Valeurs des codes de retour

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

Notes

sp_addlreader_agent est utilisé dans la réplication transactionnelle.

sp_addqreader_agent doit être exécuté au minimum une fois sur le serveur de distribution qui prend en charge la mise en file d'attente après l'exécution de sp_adddistributiondb mais avant l'exécution de sp_addpublication.

Le travail de l'Agent de lecture de la file d'attente est supprimé lorsque vous exécutez sp_dropdistributiondb.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter sp_addqreader_agent.

Voir aussi

Tâches

Mettre à niveau les scripts de réplication (programmation Transact-SQL de la réplication)

Référence

sp_changeqreader_agent (Transact-SQL)

sp_helpqreader_agent (Transact-SQL)

Concepts

Abonnements pouvant être mis à jour pour la réplication transactionnelle