sp_MSchange_distribution_agent_properties (Transact-SQL)
Ändert die Eigenschaften eines Verteilungs-Agent-Auftrags, der auf einem Verteiler mit MicrosoftSQL 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.
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'
Der Name der Veröffentlichung. publication ist vom Datentyp sysname und hat keinen Standardwert.[ @subscriber= ] 'subscriber'
Der Name des Abonnenten. subscriber ist vom Datentyp sysname und hat keinen Standardwert.[ @subscriber_db= ] 'subscriber_db'
Der Name der Abonnementdatenbank. subscriber_db ist vom Datentyp sysname und hat keinen Standardwert.[ @property=] 'property'
Die Veröffentlichungseigenschaft, die geändert werden soll. property ist vom Datentyp sysname und hat keinen Standardwert.[ @value=] 'value'
Der neue Wert der Eigenschaft. 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
Der 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
Der Name der Datenquelle, so wie er vom OLE DB-Anbieter interpretiert wird. Diese Eigenschaft ist nur für andere als SQL Server-Abonnenten gültig.
subscriber_location
Der Speicherort der Datenbank, so wie er vom OLE DB-Anbieter interpretiert wird. 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 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-Datenquellserver
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-to-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 Snapshot- 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.