sp_changesubscription (Transact-SQL)sp_changesubscription (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

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.Changes the properties of a snapshot or transactional push subscription or a pull subscription involved in queued updating transactional replication. Pour modifier les propriétés de tous les autres types d’abonnements par extraction, utilisez sp_change_subscription_properties (Transact-SQL).To change properties of all other types of pull subscriptions, use sp_change_subscription_properties (Transact-SQL). sp_changesubscription est exécutée sur la base de données de publication sur le serveur de publication.sp_changesubscription is executed at the Publisher on the publication database.

Important

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.When configuring a Publisher with a remote Distributor, the values supplied for all parameters, including job_login and job_password, are sent to the Distributor as plain text. 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.You should encrypt the connection between the Publisher and its remote Distributor before executing this stored procedure. Pour plus d’informations, consultez Activer des connexions chiffrées dans le moteur de base de données (Gestionnaire de configuration SQL Server).For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication à modifier.[ @publication = ] 'publication' Is the name of the publication to change. publicationest de type sysname, sans valeur par défautpublicationis sysname, with no default

[ @article = ] 'article'Nom de l’article à modifier.[ @article = ] 'article' Is the name of the article to change. article est de type sysnameet n’a pas de valeur par défaut.article is sysname, with no default.

[ @subscriber = ] 'subscriber'Nom de l’abonné.[ @subscriber = ] 'subscriber' Is the name of the Subscriber. Subscriber est de type sysname, sans valeur par défaut.subscriber is sysname, with no default.

[ @destination_db = ] 'destination_db'Nom de la base de données d’abonnement.[ @destination_db = ] 'destination_db' Is the name of the subscription database. destination_db est de type sysname, sans valeur par défaut.destination_db is sysname, with no default.

[ @property = ] 'property'Propriété à modifier pour l’abonnement donné.[ @property = ] 'property' Is the property to change for the given subscription. la propriété est de type nvarchar (30) et peut prendre l’une des valeurs de la table.property is nvarchar(30), and can be one of the values in the table.

[ @value = ] 'value'Nouvelle valeur de la propriétéspécifiée.[ @value = ] 'value' Is the new value for the specified property. la valeur est de type nvarchar (4000) et peut prendre l’une des valeurs de la table.value is nvarchar(4000), and can be one of the values in the table.

PropriétéProperty ValueValue DescriptionDescription
distrib_job_logindistrib_job_login Nom de connexion du compte MicrosoftMicrosoft Windows sous lequel l'Agent s'exécute.Login for the MicrosoftMicrosoft Windows account under which the agent runs.
distrib_job_passworddistrib_job_password Mot de passe du compte Windows sous lequel l’agent s’exécute.Password for the Windows account under which the agent runs.
subscriber_catalogsubscriber_catalog Catalogue à utiliser lors d’une connexion au fournisseur OLE DB.Catalog to be used when making a connection to the OLE DB provider. Cette propriété n’est valide que pour lesMicrosoftMicrosoft abonnés non- SQL ServerSQL Server .This property is only valid for non-MicrosoftMicrosoft SQL ServerSQL Server Subscribers.
subscriber_datasourcesubscriber_datasource Nom de la source de données tel qu'il est interprété par le fournisseur OLE DB.Name of the data source as understood by the OLE DB provider. Cette propriété n’est valide que pour les abonnés non- SQL ServerSQL Server .This property is only valid for non-SQL ServerSQL Server Subscribers.
subscriber_locationsubscriber_location Emplacement de la base de données tel qu’il est interprété par le fournisseur OLE DB.Location of the database as understood by the OLE DB provider. Cette propriété n’est valide que pour les abonnés non- SQL ServerSQL Server .This property is only valid for non-SQL ServerSQL Server Subscribers.
subscriber_loginsubscriber_login Nom de la connexion du côté Abonné.Login name at the Subscriber.
subscriber_passwordsubscriber_password Mot de passe fort pour le nom de connexion fourni.Strong password for the supplied login.
subscriber_security_modesubscriber_security_mode 11 Utilise l'authentification Windows pour la connexion à l'Abonné.Use Windows Authentication when connecting to the Subscriber.
00 Utiliser l'authentification SQL ServerSQL Server pour la connexion à l'Abonné.Use SQL ServerSQL Server Authentication when connecting to the Subscriber.
subscriber_providersubscriber_provider Identificateur de programme unique (PROGID) avec lequel le fournisseur OLE DB de la source de données non-SQL ServerSQL Server est inscrit.Unique programmatic identifier (PROGID) with which the OLE DB provider for the non-SQL ServerSQL Server data source is registered. Cette propriété n’est valide que pour les abonnés non- SQL ServerSQL Server .This property is only valid for non-SQL ServerSQL Server Subscribers.
subscriber_providerstringsubscriber_providerstring Chaîne de connexion propre au fournisseur OLE DB qui identifie la source de données.OLE DB provider-specific connection string that identifies the data source. Cette propriété n’est valide que pour les abonnés non- SQL ServerSQL Server .This property is only valid for non-SQL ServerSQL Server Subscribers.
SubscriptionStreamssubscriptionstreams Nombre de connexions autorisées par Agent de distribution pour appliquer en parallèle des traitements de modifications à un Abonné.Is the number of connections allowed per Distribution Agent to apply batches of changes in parallel to a Subscriber. Une plage de valeurs comprises entre 1 et 64 est prise en charge pour les serveurs de SQL ServerSQL Server publication.A range of values from 1 to 64 is supported for SQL ServerSQL Server Publishers. Cette propriété doit être égale à 0 pourSQL ServerSQL Server les abonnés non-, les serveurs de publication Oracle ou les abonnements d’égal à égal.This property must be 0 for non-SQL ServerSQL Server Subscribers, Oracle Publishers or peer-to-peer subscriptions.
subscriber_typesubscriber_type 11 Serveur de la source de données ODBC.ODBC data source server
33 Fournisseur OLE DBOLE DB provider
memory_optimizedmemory_optimized bitbit Indique que l’abonnement prend en charge les tables optimisées en mémoire.Indicates that the subscription supports memory optimized tables. memory_optimized est de bits, où 1 est égal à true (l’abonnement prend en charge les tables optimisées en mémoire).memory_optimized is bit, where 1 equals true (the subscription supports memory optimized tables).

[ @publisher = ] 'publisher'Spécifie un serveur SQL ServerSQL Server de publication non-.[ @publisher = ] 'publisher' Specifies a non- SQL ServerSQL Server Publisher. Publisher est de type sysname, avec NULL comme valeur par défaut.publisher is sysname, with a default of NULL.

Notes

l' éditeur ne doit pas être spécifié SQL ServerSQL Server pour un serveur de publication.publisher should not be specified for a SQL ServerSQL Server Publisher.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_changesubscription est utilisé dans la réplication transactionnelle et d’instantané.sp_changesubscription is used in snapshot and transactional replication.

sp_changesubscription peut uniquement être utilisé pour modifier les propriétés des abonnements par émission de type push ou des abonnements par extraction impliqués dans la réplication transactionnelle de mise à jour en file d’attente.sp_changesubscription can only be used to modify the properties of push subscriptions or pull subscriptions involved in queued updating transactional replication. Pour modifier les propriétés de tous les autres types d’abonnements par extraction, utilisez sp_change_subscription_properties (Transact-SQL).To change properties of all other types of pull subscriptions, use 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.After changing an agent login or password, you must stop and restart the agent before the change takes effect.

AutorisationsPermissions

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.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_changesubscription.

Voir aussiSee Also

sp_addsubscription (Transact-SQL) sp_addsubscription (Transact-SQL)
sp_dropsubscription (Transact-SQL)sp_dropsubscription (Transact-SQL)