sp_MSchange_distribution_agent_properties (Transact-SQL)

Article
12/22/2023

S’applique à :SQL Server

Modifie les propriétés d’un travail Agent de distribution qui s’exécute sur un serveur de distribution microsoft SQL Server 2005 (9.x) ou version ultérieure. Cette procédure stockée est utilisée pour modifier les propriétés lorsque le serveur de publication s’exécute sur une instance de 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.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @publisher = ] 'publisher' Nom du serveur de publication. publisher est sysname, sans valeur par défaut.

[ @publisher_db = ] 'publisher_db' Nom de la base de données de publication. publisher_db est sysname, sans valeur par défaut.

[ @publication = ] 'publication' Nom de la composition. la publication est sysname, sans valeur par défaut.

[ @subscriber = ] 'subscriber' Nom de l’Abonné. l’abonné est sysname, sans valeur par défaut.

[ @subscriber_db = ] 'subscriber_db' Nom de la base de données d’abonnement. subscriber_db est sysname, sans valeur par défaut.

[ @property = ] 'property' Propriété de publication à modifier. est sysname, sans valeur par défaut.

[ @value = ] 'value' Valeur de la nouvelle propriété. la valeur est nvarchar(524), avec la valeur NULL par défaut.

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.

Propriété	Valeur	Description
distrib_job_login		Connectez-vous au compte Microsoft Windows sous lequel l’agent s’exécute.
distrib_job_password		Mot de passe du compte Windows sous lequel le travail de l'Agent s'exécute.
subscriber_catalog		Catalogue à utiliser lors d’une connexion au fournisseur OLE DB. Cette propriété est valide uniquement pour les abonnés non-SQL Server .
subscriber_datasource		Nom de la source de données tel qu'il est interprété par le fournisseur OLE DB. Cette propriété est valide uniquement pour les abonnés non-SQL Server .
subscriber_location		Emplacement de la base de données tel qu’il est compris par le fournisseur OLE DB. Cette propriété est valide uniquement pour les abonnés non-SQL Server .
subscriber_login		Nom de connexion à utiliser lors de la connexion à un Abonné pour synchroniser l'abonnement.
subscriber_password		Mot de passe de l’abonné. N'utilisez pas de mot de passe vide. Utilisez un mot de passe fort.
subscriber_provider		Identificateur de programme unique (PROGID) avec lequel le fournisseur OLE DB de la source de données non-SQL Server est inscrit. Cette propriété est valide uniquement pour les abonnés non-SQL Server .
subscriber_providerstring		Chaîne de connexion propre au fournisseur OLE DB qui identifie la source de données. Cette propriété est valide uniquement pour les abonnés non-SQL Server.
subscriber_security_mode	1	Authentification Windows. Lorsque c'est possible, utilisez l'authentification Windows.
	0	Authentification SQL Server.
subscriber_type	0	Abonné SQL Server
	1	Serveur de la source de données ODBC.
	3	Fournisseur OLE DB
subscriptionstreams		Indique le nombre de connexions autorisées par Agent de distribution pour appliquer en parallèle des traitements de modifications à un Abonné. Non pris en charge pour les abonnés non-SQL Server , les serveurs de publication Oracle ou les abonnements d’égal à égal.

Remarque

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.

Codet de retour

0 (réussite) ou 1 (échec)

Notes

sp_MSchange_distribution_agent_properties est utilisé dans la réplication instantané et la réplication transactionnelle.

Lorsque le serveur de publication s’exécute sur une instance de SQL Server 2005 (9.x) ou version ultérieure, vous devez utiliser sp_changesubscription pour modifier les propriétés d’un travail de Agent de fusion qui synchronise un abonnement Push qui s’exécute sur le serveur de distribution.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin sur le serveur de distribution peuvent exécuter sp_MSchange_distribution_agent_properties.

Voir aussi

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