• Artikel

sp_MSchange_distribution_agent_properties (Transact-SQL)

Ändert die Eigenschaften eines Verteilungs-Agent-Auftrags, der auf einem Verteiler mit Microsoft SQL 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.

Themenlink (Symbol)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'
    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.
    HinweisHinweis

    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.