Partager via


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 données de publication de l'Abonné.

Icône Lien de rubriqueConventions 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é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 d'agent existant. dbname 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 la valeur par défaut 0. 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.