sp_enableagentoffload (Transact-SQL)

Ermöglicht die Remoteaktivierung des Replikationspush-Agents, der durch den @job_id-Parameter identifiziert wird. Diese gespeicherte Prozedur wird auf dem Computer ausgeführt, der zurzeit den Remote-Agent-Server darstellt. Diese gespeicherte Prozedur wird beim Verleger mit der Publikationsdatenbank ausgeführt.

Wichtig:
Die Remoteaktivierung des Agents wird für Verteiler, die Microsoft SQL Server 2005 und höher ausführen, nicht mehr unterstützt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_enableagentoffload [ @job_id = ] job_id
    [ , [ @offloadserver = ] 'remote_agent_server_name' ]
    [ , [ @agent_type = ] 'agent_type' ]

Argumente

• [ @job_id =] 'job_id'
  Gibt die SQL Server-Agent-Auftrags-ID des Replikations-Agents an, der für die Remoteaktivierung aktiviert werden soll. job_id ist vom Datentyp varbinary(16) und hat keinen Standardwert.

• [ @offloadserver= ] 'remote_agent_server_name'
  Gibt den Netzwerknamen des Servers an, der für die Remoteaktivierung des Agents aktiviert werden soll. remote_agent_server_name ist vom Datentyp sysname und hat den Standardwert NULL. Bei einem Wert von NULL wird der aktuelle offload_server-Wert in der MSDistribution_agents-Tabelle verwendet.

• [ @agent_type = ] 'agent_type'
  Gibt den Agenttyp an. agent_type ist vom Datentyp sysname und hat den Standardwert NULL, der angibt, dass vom System bestimmt wird, ob der Agent ein Verteilungs-Agent oder ein Merge-Agent ist. Gültige Werte sind distribution, merge oder NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_enableagentoffload wird dazu verwendet, die Ausführung des Verteilungs-Agents oder des Merge-Agents auf einem anderen Server zu aktivieren.

Beim erfolgreichen Abschluss von sp_enableagentoffload wird der Parameter –Offloadoffloadserver an die Befehlszeile des Replikations-Agents angefügt oder mit dem neuen Wert von 'remote_agent_server_name' aktualisiert, wenn der Parameter –Offloadoffloadserver bereits in der Befehlszeile vorhanden ist.

Außerdem wird das Feld offload_enabled für den Agent in MSdistribution_agents (Transact-SQL) auf 1 festgelegt, und das Feld offload_server wird mit dem neuen Wert aktualisiert, der in 'remote_agent_server_name' (falls bereitgestellt) angegeben wurde.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin, der festen Datenbankrolle db_owner oder der Abonnementbesitzer des angegebenen Agents können sp_enableagentoffload ausführen.

Siehe auch

Verweis

Gespeicherte Systemprozeduren (Transact-SQL)

Hilfe und Informationen

Informationsquellen für SQL Server 2005