Freigeben über


sp_changesubscription (Transact-SQL)

Ändert die Eigenschaften eines Momentaufnahme- oder Transaktionspushabonnements bzw. eines Pullabonnements, das an einem verzögerten Update ü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 dem Verleger für die Veröffentlichungsdatenbank ausgeführt.

SicherheitshinweisSicherheitshinweis

Beim Konfigurieren 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 Aktivieren von verschlüsselten Verbindungen zum Datenbankmodul (SQL Server-Konfigurations-Manager).

Themenlink (Symbol) 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 Veröffentlichung, die geändert werden soll. publicationist vom Datentyp sysname und hat keinen Standardwert.

  • [ @article = ] 'article'
    Der Name des zu ändernden Artikels. article ist vom Datentyp sysname und hat keinen Standardwert.

  • [ @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) und kann einen der Werte in der Tabelle aufweisen.

  • [ @value=] 'value'
    Der neue Wert für die angegebene property. value ist vom Datentyp nvarchar(4000) und kann einen der Werte in der Tabelle aufweisen.

    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-zu-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.

    HinweisHinweis

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

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_changesubscription wird bei der Momentaufnahme- und der Transaktionsreplikation verwendet.

sp_changesubscription kann nur zum Ändern der Eigenschaften von Pushabonnements oder Pullabonnements verwendet werden, die an einer Transaktionsreplikation durch verzögertes Update ü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 Kennworts 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)