Partager via

sp_MSchange_distribution_agent_properties (Transact-SQL)

  • Article

S'applique à : SQL Server

Modifie les propriétés d’un travail Agent de distribution qui s’exécute sur un serveur de distribution 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 = ] N'publisher'
    , [ @publisher_db = ] N'publisher_db'
    , [ @publication = ] N'publication'
    , [ @subscriber = ] N'subscriber'
    , [ @subscriber_db = ] N'subscriber_db'
    , [ @property = ] N'property'
    , [ @value = ] N'value'
[ ; ]

Arguments

[ @publisher = ] N’publisher'

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

[ @publisher_db = ] N’publisher_db'

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

[ @publication = ] N’publication'

Nom de la publication. @publication est sysname, sans valeur par défaut.

[ @subscriber = ] N’subscriber'

Nom de l'Abonné. @subscriber est sysname, sans valeur par défaut.

[ @subscriber_db = ] N’subscriber_db'

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

[ @property = ] N’property'

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

[ @value = ] N’value'

Nouvelle valeur de la propriété . @value est nvarchar(524), sans valeur 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 1 Catalogue à utiliser lors d’une connexion au fournisseur OLE DB.
subscriber_datasource 1 Nom de la source de données tel qu'il est interprété par le fournisseur OLE DB.
subscriber_location 1 Emplacement de la base de données tel qu’il est compris par le fournisseur OLE DB.
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 1 Identificateur de programme unique (PROGID) avec lequel le fournisseur OLE DB de la source de données non-SQL Server est inscrit.
subscriber_providerstring 1 Chaîne de connexion propre au fournisseur OLE DB qui identifie la source de données.
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 2 Indique le nombre de connexions autorisées par Agent de distribution pour appliquer en parallèle des traitements de modifications à un Abonné.

1 Valide uniquement pour les abonnés non-SQL Server.

2 Non pris en charge pour les abonnés non-SQL Server, les serveurs de publication Oracle ou les abonnements pair à pair.

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.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

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

Vous pouvez utiliser sp_changesubscription sur un serveur de publication pour modifier les propriétés d’un travail 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 s’exécuter sp_MSchange_distribution_agent_properties.

Contenu connexe