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

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Modifie les propriétés d’un travail d’Agent de Distribution s’exécute sur un MicrosoftMicrosoft SQL Server 2005 (9.x)SQL Server 2005 (9.x) ou version ultérieure du serveur de distribution.Changes the properties of a Distribution Agent job that runs at a MicrosoftMicrosoft SQL Server 2005 (9.x)SQL Server 2005 (9.x) or later version Distributor. Cette procédure stockée est utilisée pour modifier des propriétés lorsque le serveur de publication s'exécute sur une instance de SQL Server 2000 (8.x)SQL Server 2000 (8.x).This stored procedure is used to change properties when the Publisher runs on an instance of SQL Server 2000 (8.x)SQL Server 2000 (8.x). Cette procédure stockée est exécutée au niveau du serveur de distribution sur la base de données de distribution.This stored procedure is executed at the Distributor on the distribution database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @publisher = ] 'publisher' Est le nom du serveur de publication.[ @publisher = ] 'publisher' Is the name of the Publisher. serveur de publication est sysname, sans valeur par défaut.publisher is sysname, with no default.

[ @publisher_db = ] 'publisher_db' Est le nom de la base de données de publication.[ @publisher_db = ] 'publisher_db' Is the name of the publication database. publisher_db est sysname, sans valeur par défaut.publisher_db is sysname, with no default.

[ @publication = ] 'publication' Est le nom de la publication.[ @publication = ] 'publication' Is the name of the publication. publication est sysname, sans valeur par défaut.publication is sysname, with no default.

[ @subscriber = ] 'subscriber' Est le nom de l’abonné.[ @subscriber = ] 'subscriber' Is the name of the Subscriber. abonné est sysname, sans valeur par défaut.subscriber is sysname, with no default.

[ @subscriber_db = ] 'subscriber_db' Est le nom de la base de données d’abonnement.[ @subscriber_db = ] 'subscriber_db' Is the name of the subscription database. bd_abonné est sysname, sans valeur par défaut.subscriber_db is sysname, with no default.

[ @property = ] 'property' Est la propriété de publication à modifier.[ @property = ] 'property' Is the publication property to change. propriété est sysname, sans valeur par défaut.property is sysname, with no default.

[ @value = ] 'value' Est la nouvelle valeur de propriété.[ @value = ] 'value' Is the new property value. valeur est nvarchar (524) , avec NULL comme valeur par défaut.value is nvarchar(524), with a default of NULL.

Le tableau ci-dessous décrit les propriétés modifiables du travail de l'Agent de distribution et les limites liées aux valeurs de ces propriétés.This table describes the properties of the Distribution Agent job that can be changed, and restrictions on the values for those properties.

PropriétéProperty ValueValue DescriptionDescription
distrib_job_logindistrib_job_login Nom de connexion du compte MicrosoftMicrosoft Windows sous lequel l'Agent s'exécute.Login for the MicrosoftMicrosoft Windows account under which the agent runs.
distrib_job_passworddistrib_job_password Mot de passe du compte Windows sous lequel le travail de l'Agent s'exécute.Password for the Windows account under which the agent job runs.
subscriber_catalogsubscriber_catalog Catalogue à utiliser lors d’une connexion au fournisseur OLE DB.Catalog to be used when making a connection to the OLE DB provider. Cette propriété est uniquement valide pour les non - SQL ServerSQL Server abonnés.This property is only valid for non-SQL ServerSQL Server Subscribers.
subscriber_datasourcesubscriber_datasource Nom de la source de données tel qu'il est interprété par le fournisseur OLE DB.Name of the data source as understood by the OLE DB provider. Cette propriété est uniquement valide pour les non - SQL ServerSQL Server abonnés.This property is only valid for non-SQL ServerSQL Server Subscribers.
subscriber_locationsubscriber_location Emplacement de la base de données interprété par le fournisseur OLE DB.Location of the database as understood by the OLE DB provider. Cette propriété est uniquement valide pour les non - SQL ServerSQL Server abonnés.This property is only valid for non-SQL ServerSQL Server Subscribers.
subscriber_loginsubscriber_login Nom de connexion à utiliser lors de la connexion à un Abonné pour synchroniser l'abonnement.Login to use when connecting to a Subscriber to synchronize the subscription.
subscriber_passwordsubscriber_password Mot de passe abonné.Subscriber password.

N'utilisez pas de mot de passe vide.Do not use a blank password. Utilisez un mot de passe fort.Use a strong password.
subscriber_providersubscriber_provider Identificateur de programme unique (PROGID) avec lequel le fournisseur OLE DB de la source de données non-SQL ServerSQL Server est inscrit.Unique programmatic identifier (PROGID) with which the OLE DB provider for the non-SQL ServerSQL Server data source is registered. Cette propriété est uniquement valide pour les non - SQL ServerSQL Server abonnés.This property is only valid for non-SQL ServerSQL Server Subscribers.
subscriber_providerstringsubscriber_providerstring Chaîne de connexion propre au fournisseur OLE DB qui identifie la source de données.OLE DB provider-specific connection string that identifies the data source. Cette propriété est uniquement valide pour les abonnés non SQL Server.This property is only valid for non-SQL Server Subscribers.
subscriber_security_modesubscriber_security_mode 11 Authentification Windows.Windows Authentication.

Lorsque c'est possible, utilisez l'authentification Windows.When possible, use Windows authentication.
00 Authentification SQL ServerSQL Server.SQL ServerSQL Server Authentication.
subscriber_typesubscriber_type 00 SQL ServerSQL Server abonnéSubscriber
11 Serveur de la source de données ODBC.ODBC data source server
33 Fournisseur OLE DBOLE DB provider
flux d’abonnementssubscriptionstreams Indique le nombre de connexions autorisées par Agent de distribution pour appliquer en parallèle des traitements de modifications à un Abonné.Denotes the number of connections allowed per Distribution Agent to apply batches of changes in parallel to a Subscriber. Non pris en charge pour les non - SQL ServerSQL Server les abonnés, les serveurs de publication Oracle ou les abonnements d’égal à égal.Not supported for non-SQL ServerSQL Server Subscribers, Oracle Publishers, or peer-to-peer subscriptions.

Notes

Après avoir modifié le nom de connexion ou le mot de passe d'un Agent, vous devez arrêter et redémarrer celui-ci avant que la modification prenne effet.After changing an agent login or password, you must stop and restart the agent before the change takes effect.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_MSchange_distribution_agent_properties est utilisé dans la réplication d’instantané ou transactionnelle.sp_MSchange_distribution_agent_properties is used in snapshot replication and transactional replication.

Lorsque le serveur de publication s’exécute sur une instance de SQL Server 2005 (9.x)SQL Server 2005 (9.x) ou version ultérieure, vous devez utiliser sp_changesubscription pour modifier les propriétés d’un travail d’Agent de fusion qui synchronise un abonnement envoyé qui s’exécute sur le serveur de distribution.When the Publisher runs on an instance of SQL Server 2005 (9.x)SQL Server 2005 (9.x) 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.

AutorisationsPermissions

Seuls les membres de la sysadmin du rôle serveur fixe sur le serveur de distribution peuvent exécuter sp_MSchange_distribution_agent_properties.Only members of the sysadmin fixed server role at the Distributor can execute sp_MSchange_distribution_agent_properties.

Voir aussiSee Also

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