sp_changesubscription (Transact-SQL)

Modifie les propriétés d'un abonnement par envoi de données (push) ou par extraction de données (pull) de capture instantanée ou transactionnel, qui participe à une réplication transactionnelle de mise à jour en attente. Pour modifier les propriétés de tous les autres types d'abonnements par extraction de données (pull), utilisez sp_change_subscription_properties (Transact-SQL). sp_changesubscription est exécutée dans la base de données de publication sur le serveur de publication.

Remarque relative à la sécurité

Lors de la configuration d'un serveur de publication avec un serveur de distribution distant, les valeurs fournies pour tous les paramètres, y compris job_login et job_password, sont envoyées au serveur de distribution en texte brut. Vous devez chiffrer la connexion entre le serveur de publication et son serveur de distribution distant avant d'exécuter cette procédure stockée. Pour plus d'informations, consultez Chiffrement des connexions à SQL Server.

Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_changesubscription [ @publication = ] 'publication'
        , [ @article = ] 'article'
        , [ @subscriber = ] 'subscriber'
        , [ @destination_db = ] 'destination_db'
        , [ @property = ] 'property'
        , [ @value = ] 'value'
    [ , [ @publisher = ] 'publisher' ]

Arguments

• [ @publication = ] 'publication'
  Nom de la publication à modifier. publicationest de type sysname, sans valeur par défaut.

• [ @article = ] 'article'
  Nom de l'article à modifier. article est de type sysname, sans valeur par défaut.

• [ @subscriber = ] 'subscriber'
  Nom de l'Abonné. L'argument subscriber est de type sysname et n'a pas de valeur par défaut.

• [ @destination_db = ] 'destination_db'
  Nom de la base de données d'abonnement. L'argument destination_db est de type sysname et n'a pas de valeur par défaut.

• [ @property=] 'property'
  Propriété à modifier pour l'abonnement donnée. property est de type nvarchar(30) et peut prendre une des valeurs répertoriées dans le tableau.

• [ @value=] 'value'
  Nouvelle valeur de l'argument property spécifié. value est de type nvarchar(4000) et peut prendre l'une des valeurs répertoriées dans le tableau.

  Propriété	Valeur	Description
  distrib_job_login		Nom de connexion du compte Microsoft Windows sous lequel l'Agent s'exécute.
  distrib_job_password		Mot de passe du compte Windows sous lequel l'Agent s'exécute.
  subscriber_catalog		Catalogue à utiliser lors d’une connexion au fournisseur OLE DB. Cette propriété est valide seulement pour les Abonnés non-Microsoft 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 seulement pour les Abonnés non-SQL Server..
  subscriber_location		Emplacement de la base de données tel qu'il est interprété par le fournisseur OLE DB. Cette propriété est valide seulement pour les Abonnés non-SQL Server..
  subscriber_login		Nom de connexion du côté Abonné.
  subscriber_password		Mot de passe fort pour le nom de connexion fourni.
  subscriber_security_mode	1	Utilise l'authentification Windows pour la connexion à l'Abonné.
  	0	Utilise l'authentification SQL Server pour la connexion à l'Abonné.
  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 seulement pour les non-abonnésSQL Server.
  subscriber_providerstring		Chaîne de connexion propre au fournisseur OLE DB qui identifie la source de données. Cette propriété est valide seulement pour les non-abonnésSQL Server.
  subscriptionstreams		Nombre de connexions autorisées par Agent de distribution pour appliquer en parallèle des traitements de modifications à un Abonné. Une plage de valeurs comprises entre 1 et 64 est prise en charge pour les serveurs de publication SQL Server. Cette propriété doit avoir la valeur 0 pour les Abonnés non-SQL Server, les serveurs de publication Oracle ou les abonnements d'égal à égal.
  subscriber_type	1	Serveur de la source de données ODBC.
  	3	Fournisseur OLE DB.

• [ @publisher = ] 'publisher'
  Spécifie un serveur de publication non-SQL Server. publisher est de type sysname. Sa valeur par défaut est NULL.

  Notes

  L'argument publisher ne doit pas être spécifié pour un serveur de publication SQL Server.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Notes

sp_changesubscription est utilisé dans la réplication de capture instantanée et dans la réplication transactionnelle.

sp_changesubscription peut s'utiliser uniquement pour modifier les propriétés des abonnements par envoi de données (push) ou par extraction de données (pull) qui participent à la réplication transactionnelle de mise à jour en attente. Pour modifier les propriétés de tous les autres types d'abonnements par extraction de données (pull), utilisez sp_change_subscription_properties (Transact-SQL).

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.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin ou du rôle de base de données fixe db_owner peuvent exécuter sp_changesubscription.

Voir aussi

Référence

sp_addsubscription (Transact-SQL)

sp_dropsubscription (Transact-SQL)