sp_MSchange_distribution_agent_properties (Transact-SQL)

Artikel
05/07/2013

Ändert die Eigenschaften eines Verteilungs-Agent-Auftrags, der auf einem Verteiler mit Microsoft SQL Server 2005 oder einer höheren Version ausgeführt wird. Diese gespeicherte Prozedur wird zum Ändern von Eigenschaften verwendet, wenn der Verleger in einer Instanz von SQL Server 2000 ausgeführt wird. Diese gespeicherte Prozedur wird auf dem Verteiler für die Verteilungsdatenbank ausgeführt.

Themenlink (Symbol) 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'
Der Name des Verlegers. publisher ist vom Datentyp sysname und hat keinen Standardwert.
[ @publisher_db= ] 'publisher_db'
Der Name der Veröffentlichungsdatenbank. publisher_db ist vom Datentyp sysname und hat keinen Standardwert.
[ @publication = ] 'publication'
Entspricht dem Namen der Veröffentlichung. publication ist vom Datentyp sysname und hat keinen Standardwert.
[ @subscriber= ] 'subscriber'
Entspricht dem Namen des Abonnenten. subscriber ist vom Datentyp sysname und hat keinen Standardwert.
[ @subscriber_db= ] 'subscriber_db'
Entspricht dem Namen der Abonnementdatenbank. subscriber_db ist vom Datentyp sysname und hat keinen Standardwert.
[ @property = ] 'property'
Der Name der zu ändernden Veröffentlichungseigenschaft. property ist vom Datentyp sysname und hat keinen Standardwert.

[ @value = ] 'value'
Der neue Eigenschaftswert. value ist vom Datentyp nvarchar(524). Der Standardwert ist NULL.

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		Anmeldename für das Microsoft Windows-Konto, unter dem der Agent ausgeführt wird.
distrib_job_password		Das Kennwort für das Windows-Konto, unter dem der Agentauftrag ausgeführt wird.
subscriber_catalog		Der Katalog, der verwendet werden soll, wenn eine Verbindung mit dem OLE DB-Anbieter hergestellt wird. Diese Eigenschaft ist nur für andere als SQL Server-Abonnenten gültig.
subscriber_datasource		Name der Datenquelle im vom OLE DB-Anbieter unterstützten Format. Diese Eigenschaft ist nur gültig für Nicht-SQL Server-Abonnenten.
subscriber_location		Speicherort der Datenbank im vom OLE DB-Anbieter unterstützten Format. Diese Eigenschaft ist nur für andere als SQL Server-Abonnenten gültig.
subscriber_login		Der Anmeldename, der beim Herstellen einer Verbindung mit einem Abonnenten zum Synchronisieren des Abonnements verwendet wird
subscriber_password		Das Kennwort des Abonnenten Verwenden Sie kein leeres Kennwort. Verwenden Sie ein sicheres Kennwort.
subscriber_provider		Die eindeutige ProgID, mit der der OLE DB-Anbieter für eine andere als eine SQL Server-Datenquelle registriert wird. Diese Eigenschaft ist nur für andere als SQL Server-Abonnenten gültig.
subscriber_providerstring		Die für den OLE DB-Anbieter zu verwendende Verbindungszeichenfolge, die die Datenquelle identifiziert. Diese Eigenschaft ist nur für andere Abonnenten als 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. Dieser Parameter wird für Nicht-SQL Server-Abonnenten, Oracle-Verleger oder Peer-zu-Peer-Abonnements nicht unterstützt.

Hinweis
Wenn Sie den Anmeldenamen oder das Kennwort für einen Agent geändert haben, müssen Sie den Agent beenden und neu starten, damit die Änderung wirksam wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_MSchange_distribution_agent_properties wird bei der Momentaufnahme- und Transaktionsreplikation verwendet.

Wenn der Verleger in einer Instanz von SQL Server 2005 oder einer höheren Version ausgeführt wird, sollten Sie sp_changesubscription verwenden, um Eigenschaften eines Merge-Agent-Auftrags zu ändern, der ein auf dem Verteiler ausgeführtes Pushabonnement synchronisiert.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin auf dem Verteiler können sp_MSchange_distribution_agent_properties ausführen.

Siehe auch

Verweis

sp_addpushsubscription_agent (Transact-SQL)

sp_addsubscription (Transact-SQL)

Freigeben über