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

Gilt für: JaSQL Server JaAzure SQL-Datenbank (nur verwaltete Instanz) NeinAzure Synapse Analytics (SQL DW) NeinParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Fügt einen Warteschlangenlese-Agent für einen bestimmten Verteiler hinzu.Adds a Queue Reader agent for a given Distributor. Diese gespeicherte Prozedur wird auf dem Verteiler für die Verteilungsdatenbank oder auf dem Verleger für die Veröffentlichungsdatenbank ausgeführt.This stored procedure is executed at the Distributor on the distribution database or at the Publisher on the publication database.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

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

ArgumenteArguments

[ @job_login = ] 'job_login'Der Anmelde Name für das MicrosoftMicrosoft Windows-Konto, unter dem der Agent ausgeführt wird.[ @job_login = ] 'job_login' Is the login for the MicrosoftMicrosoft Windows account under which the agent runs. job_login ist vom Datentyp nvarchar (257) und hat keinen Standardwert.job_login is nvarchar(257), with no default. Das Windows-Konto wird stets für Agent-Verbindungen mit dem Verteiler verwendet.This Windows account is always used for agent connections to the Distributor.

[ @job_password = ] 'job_password'Das Kennwort für das Windows-Konto, unter dem der Agent ausgeführt wird.[ @job_password = ] 'job_password' Is the password for the Windows account under which the agent runs. job_password ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.job_password is sysname, with no default.

Wichtig

Speichern Sie keine Authentifizierungsinformationen in Skriptdateien.Do not store authentication information in script files. Für die optimale Sicherheit sollten Anmeldenamen und Kennwörter zur Laufzeit bereitgestellt werden.For best security, login names and passwords should be supplied at runtime.

[ @job_name = ] 'job_name'Der Name eines vorhandenen Agentauftrags.[ @job_name = ] 'job_name' Is the name of an existing agent job. job_name ist vom Datentyp vom Datentyp sysnameund hat den Standardwert NULL.job_name is sysname, with a default value of NULL. Dieser Parameter wird nur dann angegeben, wenn der Agent mit einem vorhandenen Auftrag anstatt mit einem neu erstellten Auftrag (Standard) erstellt wird.This parameter is only specified when the agent is created using an existing job instead of a newly created job (the default).

[ @frompublisher = ] frompublisherGibt an, ob die Prozedur auf dem Verleger ausgeführt wird.[ @frompublisher = ] frompublisher Specifies whether the procedure is being executed at the Publisher. frompublisher ist vom Typ Bit und hat den Standardwert 0.frompublisher is bit, with a default value of 0. Der Wert 1 bedeutet, dass die Prozedur auf dem Verleger für die Veröffentlichungs Datenbank ausgeführt wird.A value of 1 means that the procedure is being executed from the Publisher on the publication database.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

HinweiseRemarks

sp_addqreader_agent wird bei der Transaktions Replikation verwendet.sp_addqreader_agent is used in transactional replication.

sp_addqreader_agent muss mindestens einmal auf einem Verteiler ausgeführt werden, der das verzögerte Update über eine Warteschlange nach sp_adddistributiondb , aber vor sp_addpublicationunterstützt.sp_addqreader_agent must be executed at least once at a Distributor that supports queued updating after sp_adddistributiondb but before sp_addpublication.

Der Warteschlangenlese-Agent Auftrag wird beim Ausführen von sp_dropdistributiondbentfernt.The Queue Reader Agent job is removed when you execute sp_dropdistributiondb.

BerechtigungenPermissions

Nur Mitglieder der festen Server Rolle sysadmin können sp_addqreader_agentausführen.Only members of the sysadmin fixed server role can execute sp_addqreader_agent.

Siehe auchSee Also

Aktivieren des Aktualisierens von Abonnements für Transaktionsveröffentlichungen Enable Updating Subscriptions for Transactional Publications
Aktualisieren von Replikationsskripts (Replikationsprogrammierung mit Transact-SQL) 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)