sp_addqreader_agent (Transact-SQL)sp_addqreader_agent (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Ajoute un Agent de lecture de la file d'attente à un serveur de distribution.Adds a Queue Reader agent for a given Distributor. 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.This stored procedure is executed at the Distributor on the distribution database or at the Publisher on the publication database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @job_login = ] 'job_login'Nom de MicrosoftMicrosoft connexion du compte Windows sous lequel l’agent s’exécute.[ @job_login = ] 'job_login' Is the login for the MicrosoftMicrosoft Windows account under which the agent runs. job_login est de type nvarchar (257) , sans valeur par défaut.job_login is nvarchar(257), with no default. Ce compte Windows est toujours utilisé pour les connexions des agents au serveur de distribution.This Windows account is always used for agent connections to the Distributor.

[ @job_password = ] 'job_password'Mot de passe du compte Windows sous lequel l’agent s’exécute.[ @job_password = ] 'job_password' Is the password for the Windows account under which the agent runs. job_password est de type sysname, sans valeur par défaut.job_password is sysname, with no default.

Important

Ne stockez pas les informations d'authentification dans des fichiers de script.Do not store authentication information in script files. Pour une sécurité optimale, les noms de connexion et les mots de passe doivent être fournis au moment de l'exécution.For best security, login names and passwords should be supplied at runtime.

[ @job_name = ] 'job_name'Nom d’un travail d’agent existant.[ @job_name = ] 'job_name' Is the name of an existing agent job. nom_du_travail est de type sysname, avec NULL comme valeur par défaut.job_name is sysname, with a default value of 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).This parameter is only specified when the agent is created using an existing job instead of a newly created job (the default).

[ @frompublisher = ] frompublisherSpécifie si la procédure est exécutée sur le serveur de publication.[ @frompublisher = ] frompublisher Specifies whether the procedure is being executed at the Publisher. frompublisher est de bits, avec 0comme valeur par défaut.frompublisher is bit, with a default value of 0. La valeur 1 signifie que la procédure est exécutée à partir du serveur de publication sur la base de données de publication.A value of 1 means that the procedure is being executed from the Publisher on the publication database.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_addqreader_agent est utilisé dans la réplication transactionnelle.sp_addqreader_agent is used in transactional replication.

sp_addqreader_agent doit être exécuté au moins une fois sur un serveur de distribution qui prend en charge la mise à jour en attente après sp_adddistributiondb mais avant sp_addpublication.sp_addqreader_agent must be executed at least once at a Distributor that supports queued updating after sp_adddistributiondb but before sp_addpublication.

La tâche de Agent de lecture de la file d’attente est supprimée lorsque vous exécutez sp_dropdistributiondb.The Queue Reader Agent job is removed when you execute sp_dropdistributiondb.

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter sp_addqreader_agent.Only members of the sysadmin fixed server role can execute sp_addqreader_agent.

Voir aussiSee Also

Activer les abonnements de mise à jour pour les publications transactionnelles Enable Updating Subscriptions for Transactional Publications
Mettre à niveau les scripts de réplication (programmation Transact-SQL de la réplication) Upgrade Replication Scripts (Replication Transact-SQL Programming)
Updatable Subscriptions for Transactional Replication Updatable Subscriptions for Transactional Replication
sp_changeqreader_agent (Transact-SQL) sp_changeqreader_agent (Transact-SQL)
sp_helpqreader_agent (Transact-SQL)sp_helpqreader_agent (Transact-SQL)