sp_changesubscription (Transact-SQL)

Ändert die Eigenschaften eines Snapshot- oder Transaktionspushabonnements bzw. eines Pullabonnements, das an einer verzögerten Aktualisierung über eine Warteschlange beteiligt ist. Verwenden Sie zum Ändern der Eigenschaften aller anderen Typen von Pullabonnements sp_change_subscription_properties (Transact-SQL). sp_changesubscription wird auf der Publikationsdatenbank auf dem Verleger ausgeführt.

Sicherheitshinweis:

Bei der Konfiguration eines Verlegers mit einem Remoteverteiler werden die Werte, die für alle Parameter einschließlich job_login und job_password bereitgestellt werden, als Nur-Text an den Verteiler gesendet. Sie sollten die Verbindung zwischen dem Verleger und dem zugehörigen Remoteverteiler verschlüsseln, bevor Sie diese gespeicherte Prozedur ausführen. Weitere Informationen finden Sie unter Verschlüsseln von Verbindungen zu SQL Server.

Transact-SQL-Syntaxkonventionen

Syntax

sp_changesubscription [ @publication = ] 'publication'
        , [ @article = ] 'article'
        , [ @subscriber = ] 'subscriber'
        , [ @destination_db = ] 'destination_db'
        , [ @property = ] 'property'
        , [ @value = ] 'value'
    [ , [ @publisher = ] 'publisher' ]

Argumente

• [ @publication= ] 'publication'
  Der Name der Publikation, die geändert werden soll. publication ist vom Datentyp sysname und hat keinen Standardwert.

• [ @article = ] 'article'
  Der Name des Artikels, der geändert werden soll. article ist vom Datentyp sysname und hat keinen Standard.

• [ @subscriber = ] 'subscriber'
  Der Name des Abonnenten. subscriber ist vom Datentyp sysname und hat keinen Standardwert.

• [ @destination_db = ] 'destination_db'
  Der Name der Abonnementdatenbank. destination_db ist vom Datentyp sysname und hat keinen Standardwert.

• [ @property=] 'property'
  Die Eigenschaft, die für das angegebene Abonnement geändert werden soll. property ist vom Datentyp nvarchar(30). Mögliche Werte sind in der Tabelle aufgeführt.

• [ @value=] 'value'
  Der neue Wert für die in property angegebene Eigenschaft. value ist vom Datentyp nvarchar(4000). Mögliche Werte sind in der Tabelle aufgeführt.

  Eigenschaft	Wert	Beschreibung
  distrib_job_login		Anmeldename für das Microsoft Windows-Konto, unter dem der Agent ausgeführt wird.
  distrib_job_password		Kennwort für das Windows-Konto, unter dem der Agent ausgeführt wird.
  subscriber_catalog		Katalog, der beim Herstellen einer Verbindung mit einem OLE DB-Anbieter verwendet wird. Diese Eigenschaft ist nur gültig für Nicht-Microsoft SQL Server-Abonnenten.
  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 gültig für Nicht-SQL Server-Abonnenten.
  subscriber_login		Anmeldename auf dem Abonnenten.
  subscriber_password		Sicheres Kennwort für den angegebenen Anmeldenamen.
  subscriber_security_mode	1	Verwendung der Windows-Authentifizierung für die Verbindung mit dem Abonnenten.
  	0	Verwendung der SQL Server-Authentifizierung für die Verbindung mit dem Abonnenten.
  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 gültig für Nicht-SQL Server -Abonnenten.
  subscriber_providerstring		Für den OLE DB-Anbieter spezifische Verbindungszeichenfolge, die die Datenquelle identifiziert. Diese Eigenschaft ist nur gültig für Nicht-SQL Server -Abonnenten.
  subscriptionstreams		Die pro Verteilungs-Agent zulässige Anzahl von Verbindungen, um Batches von Änderungen parallel auf einen Abonnenten anzuwenden. Für SQL Server-Verleger wird ein Wertebereich von 1 bis 64 unterstützt. Diese Eigenschaft muss für Nicht-SQL Server-Abonnenten, Oracle-Verleger oder Peer-to-Peer-Abonnements den Wert 0 haben.
  subscriber_type	1	ODBC-Datenquellenserver
  	3	OLE DB-Anbieter

• [ @publisher = ] 'publisher'
  Gibt einen Nicht-SQL Server-Verleger an. publisher ist vom Datentyp sysname und hat den Standardwert NULL.

  Hinweis:
  publisher sollte nicht für einen SQL Server-Verleger angegeben werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_changesubscription wird bei der Snapshot- und der Transaktionsreplikation verwendet.

sp_changesubscription kann nur zum Ändern der Eigenschaften von Pushabonnements oder Pullabonnements verwendet werden, die an einer Transaktionsreplikation durch verzögerte Aktualisierung über eine Warteschlange beteiligt sind. Verwenden Sie zum Ändern der Eigenschaften aller anderen Typen von Pullabonnements sp_change_subscription_properties (Transact-SQL).

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

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder der festen Datenbankrolle db_owner können sp_changesubscription ausführen.

Siehe auch

Verweis

sp_addsubscription (Transact-SQL)
sp_dropsubscription (Transact-SQL)

Hilfe und Informationen

Informationsquellen für SQL Server 2005