sp_addqreader_agent (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

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 Transact-SQL

Syntaxe

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

Arguments

[ @job_login = ] N’job_login'

Connexion pour le compte Windows sous lequel l’agent s’exécute. @job_login est nvarchar(257), avec la valeur par défaut NULL. Ce compte Windows est toujours utilisé pour les connexions des agents au serveur de distribution.

[ @job_password = ] N’job_password'

Mot de passe du compte Windows sous lequel l’agent s’exécute. @job_password est sysname, sans valeur par défaut.

Important

Ne stockez pas les informations d’authentification dans les 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 = ] N’job_name'

Nom d’un travail d’agent existant. @job_name est sysname, avec la valeur par défaut NULL. 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 bit, avec la valeur par défaut 0.

Une valeur de 1 signifie que la procédure est exécutée à partir du serveur de publication sur la base de données de publication.

Valeurs des codes de retour

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

Notes

sp_addqreader_agent est utilisé dans la réplication transactionnelle.

sp_addqreader_agent doit être exécuté au moins une fois sur un serveur de distribution qui prend en charge la mise à jour mise à jour en file d’attente après sp_adddistributiondb mais avant sp_addpublication.

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

autorisations

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