sp_MSchange_distribution_agent_properties (Transact-SQL)
Gilt für: SQL Server
Ä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 bei der Momentaufnahmereplikation und der 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)