• Artikel

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 Veröffentlichungsdatenbank auf dem Verleger ausgeführt.

SicherheitshinweisSicherheitshinweis

 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.

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

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