sp_MSchange_distribution_agent_properties (Transact-SQL)

Artikel
12/22/2023

Ändert die Eigenschaften eines Verteilungs-Agent Auftrags, der bei einem Microsoft SQL Server 2005 (9.x) oder höher ausgeführt wird. Diese gespeicherte Prozedur wird verwendet, um Eigenschaften zu ändern, wenn der Publisher auf einer Instanz von SQL Server 2000 (8.x) ausgeführt wird. Diese gespeicherte Prozedur wird auf dem Verteiler für die Verteilungsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

  
sp_MSchange_distribution_agent_properties [ @publisher = ] 'publisher'  
        , [ @publisher_db = ] 'publisher_db'  
        , [ @publication = ] 'publication'   
        , [ @subscriber = ] 'subscriber'   
        , [ @subscriber_db = ] 'subscriber_db'   
        , [ @property = ] 'property'   
        , [ @value = ] 'value' ]

Argumente

[ @publisher = ] 'publisher' Ist der Name des Herausgebers. Publisher ist "sysname" ohne Standard.

[ @publisher_db = ] 'publisher_db' Ist der Name der Publikationsdatenbank. publisher_db ist "sysname" ohne Standard.

[ @publication = ] 'publication' Ist der Name der Publikation. Publikation ist sysname, ohne Standard.

[ @subscriber = ] 'subscriber' Ist der Name des Abonnenten. subscriber is sysname, with no default.

[ @subscriber_db = ] 'subscriber_db' Ist der Name der Abonnementdatenbank. subscriber_db ist "sysname" ohne Standard.

[ @property = ] 'property' Ändert sich die Publikationseigenschaft. "property " ist "sysname" ohne Standard.

[ @value = ] 'value' Ist der neue Eigenschaftswert. der Wert ist nvarchar(524), wobei der Standardwert NULL ist.

Diese Tabelle beschreibt die änderbaren Eigenschaften des Verteilungs-Agent-Auftrags sowie die Einschränkungen für die Werte dieser Eigenschaften.

Eigenschaft	Wert	Beschreibung
distrib_job_login		Melden Sie sich für das Microsoft Windows-Konto an, unter dem der Agent ausgeführt wird.
distrib_job_password		Kennwort für das Windows-Konto, unter dem der Agentauftrag ausgeführt wird.
subscriber_catalog		Katalog, der beim Herstellen einer Verbindung mit dem OLE DB-Anbieter verwendet werden soll. Diese Eigenschaft ist nur für Nicht-SQL Server-Abonnenten gültig.
subscriber_datasource		Name der Datenquelle im vom OLE DB-Anbieter unterstützten Format. Diese Eigenschaft ist nur für Nicht-SQL Server-Abonnenten gültig.
subscriber_location		Speicherort der Datenbank, wie vom OLE DB-Anbieter verstanden. Diese Eigenschaft ist nur für Nicht-SQL Server-Abonnenten gültig.
subscriber_login		Anmeldename, der beim Herstellen der Verbindung mit einem Abonnenten zum Synchronisieren des Abonnements verwendet werden soll.
subscriber_password		Abonnentenkennwort. Verwenden Sie kein leeres Kennwort. Verwenden Sie ein sicheres Kennwort.
subscriber_provider		Eindeutiger Programmbezeichner (PROGID, Programmatic Identifier), mit dem der OLE DB-Anbieter für die Nicht-SQL Server-Datenquelle registriert wird. Diese Eigenschaft ist nur für Nicht-SQL Server-Abonnenten gültig.
subscriber_providerstring		Für den OLE DB-Anbieter spezifische Verbindungszeichenfolge, die die Datenquelle identifiziert. Diese Eigenschaft ist nur für Nicht-SQL Server-Abonnenten gültig.
subscriber_security_mode	1	Windows-Authentifizierung. Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.
	0	SQL Server-Authentifizierung.
subscriber_type	0	SQL Server-Abonnent
	1	ODBC-Datenquellenserver
	3	OLE DB-Anbieter
subscriptionstreams		Bezeichnet die Anzahl zulässiger Verbindungen pro Verteilungs-Agent, um Änderungsbatches parallel auf einen Abonnenten anzuwenden. Wird für Nicht-SQL Server-Abonnenten, Oracle-Herausgeber oder Peer-to-Peer-Abonnements nicht unterstützt.

Hinweis

Nach dem Ändern des Anmeldenamens oder Kennworts eines Agents müssen Sie den Agent beenden und neu starten, damit die Änderungen in Kraft treten.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_MSchange_distribution_agent_properties wird in Momentaufnahme Replikation und Transaktionsreplikation verwendet.

Wenn der Publisher auf einer Instanz von SQL Server 2005 (9.x) oder höher ausgeführt wird, sollten Sie sp_changesubscription verwenden, um die Eigenschaften eines Merge-Agent Auftrags zu ändern, der ein Pushabonnement synchronisiert, das im Distributor ausgeführt wird.

Berechtigungen

Nur Mitglieder der festen Serverrolle "sysadmin" im Distributor können sp_MSchange_distribution_agent_properties ausführen.

Weitere Informationen

sp_addpushsubscription_agent (Transact-SQL)
sp_addsubscription (Transact-SQL)