sp_MSchange_distribution_agent_properties (Transact-SQL)sp_MSchange_distribution_agent_properties (Transact-SQL)

DIESES THEMA GILT FÜR:jaSQL Server (ab 2008)neinAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Ändert die Eigenschaften eines Verteilungs-Agent-Auftrags, der ausgeführt wird eine MicrosoftMicrosoft SQL Server 2005SQL Server 2005 oder höhere Version Verteiler.Changes the properties of a Distribution Agent job that runs at a MicrosoftMicrosoft SQL Server 2005SQL Server 2005 or later version Distributor. Diese gespeicherte Prozedur wird zum Ändern von Eigenschaften verwendet, wenn der Verleger in einer Instanz von SQLServer 2000 (8.x)SQL Server 2000 (8.x) ausgeführt wird.This stored procedure is used to change properties when the Publisher runs on an instance of SQLServer 2000 (8.x)SQL Server 2000 (8.x). Diese gespeicherte Prozedur wird auf dem Verteiler für die Verteilungsdatenbank ausgeführt.This stored procedure is executed at the Distributor on the distribution database.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax


sp_MSchange_distribution_agent_properties [ @publisher = ] 'publisher'  
        , [ @publisher_db = ] 'publisher_db'  
        , [ @publication = ] 'publication'   
        , [ @subscriber = ] 'subscriber'   
        , [ @subscriber_db = ] 'subscriber_db'   
        , [ @property = ] 'property'   
        , [ @value = ] 'value' ]  

ArgumenteArguments

[ @publisher = ] 'publisher'[ @publisher = ] 'publisher'
Der Name des Verlegers.Is the name of the Publisher. Publisher ist Sysname, hat keinen Standardwert.publisher is sysname, with no default.

[ @publisher_db= ] "Publisher_db"[ @publisher_db= ] 'publisher_db'
Der Name der Veröffentlichungsdatenbank.Is the name of the publication database. Publisher_db ist Sysname, hat keinen Standardwert.publisher_db is sysname, with no default.

[ @publication = ] 'publication'[ @publication = ] 'publication'
Der Name der Veröffentlichung.Is the name of the publication. Veröffentlichung ist Sysname, hat keinen Standardwert.publication is sysname, with no default.

[ @subscriber= ] "Abonnenten"[ @subscriber= ] 'subscriber'
Der Name des Abonnenten.Is the name of the Subscriber. Abonnenten ist Sysname, hat keinen Standardwert.subscriber is sysname, with no default.

[ @subscriber_db= ] "Subscriber_db"[ @subscriber_db= ] 'subscriber_db'
Ist der Name der Abonnementdatenbank.Is the name of the subscription database. Subscriber_db ist Sysname, hat keinen Standardwert.subscriber_db is sysname, with no default.

[ @property = ] "Eigenschaft"[ @property = ] 'property'
Der Name der zu ändernden Veröffentlichungseigenschaft.Is the publication property to change. Eigenschaft ist Sysname, hat keinen Standardwert.property is sysname, with no default.

[ @value = ] "Wert"[ @value = ] 'value'
Der neue Eigenschaftswert.Is the new property value. Wert ist nvarchar(524), hat den Standardwert NULL.value is nvarchar(524), with a default of NULL.

Diese Tabelle beschreibt die änderbaren Eigenschaften des Verteilungs-Agent-Auftrags sowie die Einschränkungen für die Werte dieser Eigenschaften.This table describes the properties of the Distribution Agent job that can be changed, and restrictions on the values for those properties.

EigenschaftProperty WertValue DescriptionDescription
distrib_job_logindistrib_job_login Anmeldename für das MicrosoftMicrosoft Windows-Konto, unter dem der Agent ausgeführt wird.Login for the MicrosoftMicrosoft Windows account under which the agent runs.
distrib_job_passworddistrib_job_password Kennwort für das Windows-Konto, unter dem der Agentauftrag ausgeführt wird.Password for the Windows account under which the agent job runs.
subscriber_catalogsubscriber_catalog Katalog, die beim Herstellen einer Verbindung mit dem OLE DB-Anbieter verwendet werden.Catalog to be used when making a connection to the OLE DB provider. Diese Eigenschaft ist nur gültig für nicht- SQL ServerSQL Server Abonnenten.This property is only valid for non- SQL ServerSQL Server Subscribers.
subscriber_datasourcesubscriber_datasource Name der Datenquelle im vom OLE DB-Anbieter unterstützten Format.Name of the data source as understood by the OLE DB provider. Diese Eigenschaft ist nur gültig für nicht- SQL ServerSQL Server Abonnenten.This property is only valid for non- SQL ServerSQL Server Subscribers.
subscriber_locationsubscriber_location Speicherort der Datenbank im vom OLE DB-Anbieter unterstützten Format.Location of the database as understood by the OLE DB provider. Diese Eigenschaft ist nur gültig für nicht- SQL ServerSQL Server Abonnenten.This property is only valid for non- SQL ServerSQL Server Subscribers.
subscriber_loginsubscriber_login Anmeldename, der beim Herstellen der Verbindung mit einem Abonnenten zum Synchronisieren des Abonnements verwendet werden soll.Login to use when connecting to a Subscriber to synchronize the subscription.
subscriber_passwordsubscriber_password Kennwort des Abonnenten.Subscriber password.

Verwenden Sie kein leeres Kennwort.Do not use a blank password. Verwenden Sie ein sicheres Kennwort.Use a strong password.
subscriber_providersubscriber_provider Eindeutiger Programmbezeichner (PROGID, Programmatic Identifier), mit dem der OLE DB-Anbieter für die Nicht- SQL ServerSQL Server-Datenquelle registriert wird.Unique programmatic identifier (PROGID) with which the OLE DB provider for the non- SQL ServerSQL Server data source is registered. Diese Eigenschaft ist nur gültig für nicht- SQL ServerSQL Server Abonnenten.This property is only valid for non- SQL ServerSQL Server Subscribers.
subscriber_providerstringsubscriber_providerstring Für den OLE DB-Anbieter spezifische Verbindungszeichenfolge, die die Datenquelle identifiziert.OLE DB provider-specific connection string that identifies the data source. Diese Eigenschaft gilt nur für nicht - SQL Server-Abonnenten.This property is only valid for non-SQL Server Subscribers.
subscriber_security_modesubscriber_security_mode 11 Windows-Authentifizierung.Windows Authentication.

Verwenden Sie nach Möglichkeit die Windows-Authentifizierung.When possible, use Windows Authentication.
00 SQL ServerSQL Server-Authentifizierung. Authentication.
subscriber_type kannsubscriber_type 00 SQL ServerSQL Server Abonnenten Subscriber
11 ODBC-DatenquellenserverODBC data source server
33 OLE DB-AnbieterOLE DB provider
subscriptionstreamssubscriptionstreams Bezeichnet die Anzahl zulässiger Verbindungen pro Verteilungs-Agent, um Änderungsbatches parallel auf einen Abonnenten anzuwenden.Denotes the number of connections allowed per Distribution Agent to apply batches of changes in parallel to a Subscriber. Nicht unterstützt für nicht- SQL ServerSQL Server Abonnenten, Oracle-Verleger oder Peer-zu-Peer-Abonnements.Not supported for non- SQL ServerSQL Server Subscribers, Oracle Publishers, or peer-to-peer subscriptions.

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.After changing an agent login or password, you must stop and restart the agent before the change takes effect.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

HinweiseRemarks

Sp_MSchange_distribution_agent_properties wird bei Momentaufnahme- und Transaktionsreplikation verwendet.sp_MSchange_distribution_agent_properties is used in snapshot replication and transactional replication.

Wenn der Verleger ausgeführt wird, in einer Instanz von SQL Server 2005SQL Server 2005 oder höhere Version, die Sie verwenden sollten Sp_changesubscription so ändern Sie Eigenschaften eines Merge-Agent-Auftrags, der ein Pushabonnement synchronisiert, die auf dem Verteiler ausgeführt wird.When the Publisher runs on an instance of SQL Server 2005SQL Server 2005 or later version, you should use sp_changesubscription to change properties of a Merge Agent job that synchronizes a push subscription that runs at the Distributor.

BerechtigungenPermissions

Nur Mitglieder der Sysadmin -Serverrolle auf dem Verteiler ausführen kann Sp_MSchange_distribution_agent_properties.Only members of the sysadmin fixed server role at the Distributor can execute sp_MSchange_distribution_agent_properties.

Siehe auchSee Also

sp_addpushsubscription_agent (Transact-SQL) sp_addpushsubscription_agent (Transact-SQL)
Sp_addsubscription (Transact-SQL)sp_addsubscription (Transact-SQL)