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) d'instantané 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 au niveau du serveur de publication sur la base de données 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 en texte brut au serveur de distribution. Vous devriez 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 Activer les connexions chiffrées dans le moteur de base de données (Gestionnaire de configuration 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é. subscriber est de type sysname, sans valeur par défaut.

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

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

• [ @value=] 'value'
  Nouvelle valeur de l'argument property spécifique. 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 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 seulement pour les Abonnés non-SQL 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, avec NULL comme valeur par défaut.

  [!REMARQUE]

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

Valeurs des codes de retour

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

Notes

sp_changesubscription est utilisé dans la réplication d'instantané 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)