• Article

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é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.

Icône Lien de rubriqueConventions 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-MicrosoftSQL 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.

    [!REMARQUE]

    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.