sp_disableagentoffload (Transact-SQL)

Deaktiviert die Remotepush-Agentaktivierung des Replikationspush-Agents, der durch den @job_id-Parameter identifiziert wird.. Diese gespeicherte Prozedur wird beim Verleger mit der Publikationsdatenbank ausgeführt.

Wichtig:
Die Remoteaktivierung von Agents wird für Verteiler, die in Microsoft SQL Server 2005 und höheren Versionen ausgeführt werden, nicht mehr unterstützt.

Syntax

sp_disableagentoffload [ @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 deaktiviert 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 verwendet 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'
  Der Agenttyp. 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_disableagentoffload wird dazu verwendet, die Möglichkeit zum Ausführen des Verteilungs-Agents oder des Merge-Agents auf einem anderen Server zu entfernen.

Nach erfolgreichem Abschluss von sp_disableagentoffload wird der Parameter –Offloadoffloadserver aus der Befehlszeile des Replikations-Agents entfernt. Außerdem wird das Feld offload_enabled für den Agent in MSdistribution_agents (Transact-SQL) auf 0 festgelegt und das Feld offload-server mit dem in 'remote_agent_server_name' angegebenen neuen Wert aktualisiert (falls ein solcher angegeben wurde).

Berechtigungen

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

Siehe auch

Verweis

sp_enableagentoffload (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)

Hilfe und Informationen

Informationsquellen für SQL Server 2005