sp_changepublication (Transact-SQL)sp_changepublication (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'une publication.Changes the properties of a publication. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.This stored procedure is executed at the Publisher on the publication database.

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

SyntaxeSyntax

sp_changepublication [ [ @publication = ] 'publication' ]  
    [ , [ @property = ] 'property' ]  
    [ , [ @value = ] 'value' ]  
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]  
    [ , [ @publisher = ] 'publisher' ]  

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication.[ @publication = ] 'publication' Is the name of the publication. publication est de type sysname, avec NULL comme valeur par défaut.publication is sysname, with a default of NULL.

[ @property = ] 'property'Propriété de publication à modifier.[ @property = ] 'property' Is the publication property to change. la propriété est de type nvarchar (255) .property is nvarchar(255).

[ @value = ] 'value'Nouvelle valeur de la propriété.[ @value = ] 'value' Is the new property value. la valeur est de type nvarchar (255) , avec NULL comme valeur par défaut.value is nvarchar(255), with a default of NULL.

Le tableau ci-dessous décrit les propriétés modifiables de la publication et les limites liées aux valeurs de ces propriétés.This table describes the properties of the publication that can be changed and restrictions on the values for those properties.

PropriétéProperty ValueValue DescriptionDescription
allow_anonymousallow_anonymous truetrue Des abonnements anonymes peuvent être créés pour la publication donnée, et immediate_sync doit également avoir la valeur true.Anonymous subscriptions can be created for the given publication, and immediate_sync must also be true. Ne peut pas être modifiée pour les publications d'égal à égal.Cannot be changed for peer-to-peer publications.
falsefalse Il n'est pas possible de créer des abonnements anonymes pour la publication concernée.Anonymous subscriptions cannot be created for the given publication. Ne peut pas être modifiée pour les publications d'égal à égal.Cannot be changed for peer-to-peer publications.
allow_initialize_from_backupallow_initialize_from_backup truetrue Les abonnés peuvent initialiser un abonnement à cette publication à partir d'une sauvegarde au lieu de le faire à partir d'un instantané initial.Subscribers can initialize a subscription to this publication from a backup rather than an initial snapshot. Cette propriété ne peut pas être modifiée pourMicrosoftMicrosoft les publications non- SQL ServerSQL Server .This property cannot be changed for non-MicrosoftMicrosoft SQL ServerSQL Server publications.
falsefalse Les abonnés doivent utiliser l'instantané initial.Subscribers must use the initial snapshot. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
allow_partition_switchallow_partition_switch truetrue ALTER TABLE... Les instructions SWITCH peuvent être exécutées sur la base de données publiée.ALTER TABLE...SWITCH statements can be executed against the published database. Pour plus d’informations, consultez Répliquer des tables et des index partitionnés.For more information, see Replicate Partitioned Tables and Indexes.
falsefalse ALTER TABLE... Les instructions SWITCH ne peuvent pas être exécutées sur la base de données publiée.ALTER TABLE...SWITCH statements cannot be executed against the published database.
allow_pullallow_pull truetrue Les abonnements par extraction de données (pull) sont autorisés pour la publication concernée.Pull subscriptions are allowed for the given publication. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
falsefalse Les abonnements par extraction de données (pull) sont pas autorisés pour la publication concernée.Pull subscriptions are not allowed for the given publication. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
allow_pushallow_push truetrue Les abonnements par envoi de données (push) sont autorisés pour la publication concernée.Push subscriptions are allowed for the given publication.
falsefalse Les abonnements par envoi de données (push) ne sont pas autorisés pour la publication concernée.Push subscriptions are not allowed for the given publication.
allow_subscription_copyallow_subscription_copy truetrue Active la possibilité de copier les bases de données qui sont abonnées à la publication.Enables the ability to copy databases that subscribe to this publication. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
falsefalse Désactive la possibilité de copier les bases de données qui sont abonnées à la publication.Disables the ability to copy databases that subscribe to this publication. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
alt_snapshot_folderalt_snapshot_folder Emplacement du dossier de remplacement pour l'instantané.Location of the alternate folder for the snapshot.
centralized_conflictscentralized_conflicts truetrue Les enregistrements en conflit sont stockés sur le serveur de publication.Conflict records are stored at the Publisher. Ne peut être modifiée qu'en l'absence d'abonnements actifs.Can be changed only if there are no active subscriptions. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
falsefalse Les enregistrements en conflit sont stockés à la fois sur le serveur de publication et sur l'Abonné ayant généré le conflit.Conflict records are stored at both the Publisher and at the Subscriber that caused the conflict. Ne peut être modifiée qu'en l'absence d'abonnements actifs.Can be changed only if there are no active subscriptions. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
compress_snapshotcompress_snapshot truetrue Un instantané dans un dossier d'instantanés de remplacement est compressé au format de fichier .cab.Snapshot in an alternate snapshot folder is compressed into the .cab file format. L'instantané se trouvant dans le dossier d'instantané par défaut ne peut pas être compressé.The snapshot in the default snapshot folder cannot be compressed.
falsefalse L'instantané n'est pas compressé ; c'est le comportement par défaut de la réplication.Snapshot is not compressed, which is the default behavior for replication.
conflict_policyconflict_policy pub gagnepub wins Politique de résolution des conflits de mise à jour des Abonnés dans laquelle le serveur de publication l'emporte dans le conflit.Conflict resolution policy for updating Subscribers where the Publisher wins the conflict. Cette propriété ne peut être modifiée qu'en l'absence d'abonnements actifs.This property can be changed only if there are no active subscriptions. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
Sub-initsub reinit Pour la mise à jour des Abonnés, en cas de conflit, l'abonnement doit être réinitialisé.For updating Subscribers, if a conflict occurs the subscription must be reinitialized. Cette propriété ne peut être modifiée qu'en l'absence d'abonnements actifs.This property can be changed only if there are no active subscriptions. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
sous WINSsub wins Politique de résolution des conflits de mise à jour des Abonnés dans laquelle l'Abonné l'emporte dans le conflit.Conflict resolution policy for updating Subscribers where the Subscriber wins the conflict. Cette propriété ne peut être modifiée qu'en l'absence d'abonnements actifs.This property can be changed only if there are no active subscriptions. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
conflict_retentionconflict_retention int qui spécifie la période de rétention des conflits, en jours.int that specifies the conflict retention period, in days. La rétention par défaut est de 14 jours.The default retention is 14 days. 0 signifie qu’aucun nettoyage de conflit n’est nécessaire.0 means that no conflict cleanup is needed. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
descriptiondescription Entrée facultative décrivant la publication.Optional entry describing the publication.
enabled_for_het_subenabled_for_het_sub truetrue Permet à la publication de prendre en charge des Abonnés non SQL ServerSQL Server.Enables the publication to support non-SQL ServerSQL Server Subscribers. enabled_for_het_sub ne peut pas être modifié lorsqu’il existe des abonnements à la publication.enabled_for_het_sub cannot be changed when there are subscriptions to the publication. Vous devrez peut-être exécuter des procédures stockées de réplication (Transact-SQL) pour respecter les exigences suivantes avant de définir enabled_for_het_sub sur true:You may need to execute Replication Stored Procedures (Transact-SQL) to comply with the following requirements before setting enabled_for_het_sub to true:
- allow_queued_tran doit avoir la valeur false.- allow_queued_tran must be false.
- allow_sync_tran doit avoir la valeur false.- allow_sync_tran must be false.
La modification de enabled_for_het_sub en true peut modifier les paramètres de publication existants.Changing enabled_for_het_sub to true may change existing publication settings. Pour plus d’informations, consultez Non-SQL Server Subscribers.For more information, see Non-SQL Server Subscribers. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
falsefalse La publication ne prend pas en charge les Abonnés non-SQL ServerSQL Server.Publication does not support non-SQL ServerSQL Server Subscribers. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
enabled_for_internetenabled_for_internet truetrue La publication est activée pour Internet, et le protocole FTP peut être utilisé pour le transfert des fichiers d'instantané vers un abonné.Publication is enabled for the Internet, and File Transfer Protocol (FTP) can be used to transfer the snapshot files to a subscriber. Les fichiers de synchronisation de la publication sont placés dans le répertoire suivant: C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\ftp.The synchronization files for the publication are put into the following directory: C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\ftp. ftp_address ne peut pas être null.ftp_address cannot be NULL. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
falsefalse La publication n'est pas activée pour Internet.Publication is not enabled for the Internet. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
enabled_for_p2penabled_for_p2p truetrue La publication prend en charge la réplication d'égal à égal.The publication supports peer-to-peer replication. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
Pour affecter à enabled_for_p2p la valeur true, les restrictions suivantes s’appliquent:To set enabled_for_p2p to true, the following restrictions apply:
- allow_anonymous doit avoir la valeur false- allow_anonymous must be false
- allow_dts doit avoir la valeur false.- allow_dts must be false.
- allow_initialize_from_backup doit avoir la valeur true- allow_initialize_from_backup must be true
- allow_queued_tran doit avoir la valeur false.- allow_queued_tran must be false.
- allow_sync_tran doit avoir la valeur false.- allow_sync_tran must be false.
- enabled_for_het_sub doit avoir la valeur false.- enabled_for_het_sub must be false.
- independent_agent doit avoir la valeur true.- independent_agent must be true.
- repl_freq doit être continu.- repl_freq must be continuous.
- replicate_ddl doit être 1.- replicate_ddl must be 1.
falsefalse La publication ne prend pas en charge la réplication d'égal à égal.The publication does not support peer-to-peer replication. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
ftp_addressftp_address Emplacement accessible par FTP des fichiers d'instantané de la publication.FTP accessible location of the publication snapshot files. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
ftp_loginftp_login Nom d'utilisateur permettant la connexion au service FTP ; la valeur ANONYMOUS est autorisée.User name used to connect to the FTP service, and the value ANONYMOUS is allowed. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
ftp_passwordftp_password Mot de passe associé au nom d'utilisateur utilisé pour la connexion au service FTP.Password for the user name used to connect to the FTP service. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
ftp_portftp_port Numéro de port du service FTP du serveur de distribution.Port number of the FTP service for the Distributor. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
ftp_subdirectoryftp_subdirectory Spécifie l’emplacement où les fichiers d’instantanés sont créés si la publication prend en charge la propagation d’instantanés à l’aide de FTP.Specifies where the snapshot files are created if the publication supports propagating snapshots using FTP. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
immediate_syncimmediate_sync truetrue Les fichiers de synchronisation sont créés ou recréés à chaque exécution de l'Agent d'instantané.Synchronization files for the publication are created or re-created each time the Snapshot Agent runs. Les Abonnés peuvent obtenir les fichiers de synchronisation immédiatement après l'abonnement si l'Agent d'instantané a été exécuté une fois avant l'abonnement.Subscribers are able to receive the synchronization files immediately after the subscription if the Snapshot Agent has been completed once before the subscription. Les nouveaux abonnements obtiennent les fichiers de synchronisation les plus récents, générés lors de la dernière exécution de l'Agent d'instantané.New subscriptions get the newest synchronization files generated by the most recent execution of the Snapshot Agent. independent_agent doit également avoir la valeur true.independent_agent must also be true. Consultez les remarques ci-dessous pour plus d’informations sur immediate_sync.See remarks below for additional information about immediate_sync.
falsefalse Les fichiers de synchronisation sont créés uniquement lors de nouveaux abonnements.Synchronization files are created only if there are new subscriptions. Les Abonnés ne peuvent recevoir les fichiers de synchronisation après s'être abonnés qu'après le lancement et l'exécution de l'Agent d'instantané.Subscribers cannot receive the synchronization files after the subscription until the Snapshot Agent is started and completes.
independent_agentindependent_agent truetrue La publication a son propre Agent de distribution dédié.Publication has its own dedicated Distribution Agent.
falsefalse La publication utilise un Agent de distribution partagé, et chaque paire base de données de publication/base de données d'abonnement a un Agent partagé.Publication uses a shared Distribution Agent, and each publication/subscription database pair has a shared agent.
p2p_continue_onconflictp2p_continue_onconflict truetrue L'Agent de distribution continue à traiter les modifications lorsqu'un conflit est détecté.The Distribution Agent continues to process changes when a conflict is detected.
Attention Nous vous recommandons d’utiliser la valeur par défaut FALSEde.Caution: We recommend that you use the default value of FALSE. Lorsque cette option a la valeur TRUE, le agent de distribution tente de converger les données dans la topologie en appliquant la ligne en conflit du nœud qui a l’ID d’appelant le plus élevé.When this option is set to TRUE, the Distribution Agent tries to converge data in the topology by applying the conflicting row from the node that has the highest originator ID. Cette méthode ne garantit pas la convergence.This method does not guarantee convergence. Vous devez vous assurer que la topologie est cohérente après la détection d'un conflit.You should make sure that the topology is consistent after a conflict is detected. Pour plus d'informations, consultez « Gestion des conflits » dans Conflict Detection in Peer-to-Peer Replication.For more information, see "Handling Conflicts" in Conflict Detection in Peer-to-Peer Replication.
falsefalse L'Agent de distribution cesse de traiter les modifications lorsqu'un conflit est détecté.The Distribution Agent stops processing changes when a conflict is detected.
post_snapshot_scriptpost_snapshot_script Spécifie l'emplacement d'un fichier de script Transact-SQLTransact-SQL que l'Agent de distribution exécute après l'application de tous les autres scripts et données d'objet répliqués au cours d'une synchronisation initiale.Specifies the location of a Transact-SQLTransact-SQL script file that the Distribution Agent runs after all the other replicated object scripts and data have been applied during an initial synchronization.
pre_snapshot_scriptpre_snapshot_script Spécifie l'emplacement d'un fichier de script Transact-SQLTransact-SQL que l'Agent de distribution exécute avant l'application de tous les autres scripts et données d'objet répliqués au cours d'une synchronisation initiale.Specifies the location of a Transact-SQLTransact-SQL script file that the Distribution Agent runs before all the other replicated object scripts and data have been applied during an initial synchronization.
publish_to_ActiveDirectorypublish_to_ActiveDirectory truetrue Ce paramètre est déconseillé et il n'est pris en charge que pour la compatibilité descendante des scripts.This parameter has been deprecated and is only supported for the backward compatibility of scripts. Vous ne pouvez plus ajouter d'informations de publication à MicrosoftMicrosoft Active Directory.You can no longer add publication information to the MicrosoftMicrosoft Active Directory.
falsefalse Supprime les informations de publication d'Active Directory.Removes the publication information from Active Directory.
queue_typequeue_type sqlsql Utilise SQL ServerSQL Server pour stocker les transactions.Use SQL ServerSQL Server to store transactions. Cette propriété ne peut être modifiée qu'en l'absence d'abonnements actifs.This property can be changed only if there are no active subscriptions.

Remarque : La prise en charge de l'utilisation de MicrosoftMicrosoft Message Queuing a été arrêtée.Note: Support for using MicrosoftMicrosoft Message Queuing has been discontinued. Si vous spécifiez la valeur MSMQ pour la valeur , une erreur est générée.Specifying a value of msmq for value results in an error.
repl_freqrepl_freq propositionscontinuous Publie la sortie de toutes les transactions enregistrées dans le journal.Publishes output of all log-based transactions.
snapshotsnapshot Publie uniquement les événements de synchronisation planifiés.Publishes only scheduled synchronization events.
replicate_ddlreplicate_ddl 11 Les instructions DDL (Data Definition Language) exécutées sur le serveur de publication sont répliquées.Data definition language (DDL) statements executed at the publisher are replicated. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications.
00 Les instructions DDL ne sont pas répliquées.DDL statements are not replicated. Cette propriété ne peut pas être modifiée pour les publications non-SQL ServerSQL Server.This property cannot be changed for non-SQL ServerSQL Server publications. La réplication des modifications de schéma ne peut pas être désactivée lorsque la réplication d'égal à égal est utilisée.Replication of schema changes cannot be disabled when using peer-to-peer replication.
replicate_partition_switchreplicate_partition_switch truetrue ALTER TABLE... Les instructions SWITCH exécutées sur la base de données publiée doivent être répliquées sur les abonnés.ALTER TABLE...SWITCH statements that are executed against the published database should be replicated to Subscribers. Cette option est valide uniquement si allow_partition_switch a la valeur true.This option is valid only if allow_partition_switch is set to TRUE. Pour plus d’informations, consultez Répliquer des tables et des index partitionnés.For more information, see Replicate Partitioned Tables and Indexes.
falsefalse ALTER TABLE... Les instructions SWITCH ne doivent pas être répliquées sur les abonnés.ALTER TABLE...SWITCH statements should not be replicated to Subscribers.
retentionretention entier représentant la période de rétention, en heures, pour l’activité d’abonnement.int representing the retention period, in hours, for subscription activity. Si un abonnement n'est pas actif durant la période de rétention, il est supprimé.If a subscription is not active within the retention period, it is removed.
snapshot_in_defaultfoldersnapshot_in_defaultfolder truetrue Les fichiers d'instantané sont stockés dans le dossier d'instantané par défaut.Snapshot files are stored in the default snapshot folder. Si alt_snapshot_folderest également spécifié, les fichiers d’instantané sont stockés à la fois dans les emplacements par défaut et dans d’autres emplacements.If alt_snapshot_folderis also specified, snapshot files are stored in both the default and alternate locations.
falsefalse Les fichiers d’instantané sont stockés à l’emplacement secondaire spécifié par alt_snapshot_folder.Snapshot files are stored in the alternate location specified by alt_snapshot_folder.
statusstatus activeactive Les données de publication sont disponibles immédiatement pour les Abonnés lors de la création de la publication.Publication data is available for Subscribers immediately when the publication is created. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
inactiveinactive Les données de publication ne sont pas disponibles pour les Abonnés lors de la création de la publication.Publication data are not available for Subscribers when the publication is created. Non pris en charge pour les serveurs de publication Oracle.Not supported for Oracle Publishers.
sync_methodsync_method nativenative Utilise la copie en bloc en mode natif de toutes les tables lors de la synchronisation des abonnements.Uses native-mode bulk copy output of all tables when synchronizing subscriptions.
charactercharacter Utilise la copie en bloc en mode caractère de toutes les tables lors de la synchronisation des abonnements.Uses character-mode bulk copy output of all tables when synchronizing subscriptions.
concurrentconcurrent Utilise la copie en bloc en mode natif de toutes les tables, mais ne verrouille pas les tables au cours de l'instantané.Uses native-mode bulk-copy program output of all tables, but does not lock tables during the snapshot generation process. Non valide pour la réplication d'instantané.Not valid for snapshot replication.
concurrent_cconcurrent_c Utilise la copie en bloc en mode caractère de toutes les tables, mais ne verrouille pas les tables au cours du processus de génération de l'instantané.Uses character-mode bulk copy program output of all tables, but does not lock tables during the snapshot generation process. Non valide pour la réplication d'instantané.Not valid for snapshot replication.
taskidtaskid Cette propriété est déconseillée et n'est plus prise en charge.This property has been deprecated and is no longer supported.
allow_dropallow_drop truetrue Active DROP TABLE la prise en charge des dll pour les articles qui font partie de la réplication transactionnelle.Enables DROP TABLE DLL support for articles which are part of transactional replication. Version minimale prise en charge: SQL Server 2014 (12.x)SQL Server 2014 (12.x)Service Pack 2 ou version ultérieure SQL Server 2016 (13.x)SQL Server 2016 (13.x) et Service Pack 1 ou version ultérieure.Minimum supported version: SQL Server 2014 (12.x)SQL Server 2014 (12.x) Service Pack 2 or above and SQL Server 2016 (13.x)SQL Server 2016 (13.x) Service Pack 1 or above. Référence supplémentaire: KB 3170123Additional reference: KB 3170123
falsefalse Désactive la prise DROP TABLE en charge des dll pour les articles qui font partie de la réplication transactionnelle.Disables DROP TABLE DLL support for articles that are part of transactional replication. Il s’agit de la valeur par défaut de cette propriété.This is the default value for this property.
Valeur null valeursNULL (default) Retourne la liste des valeurs prises en charge pour la propriété.Returns the list of supported values for property.

[ @force_invalidate_snapshot = ] force_invalidate_snapshotConfirme que l’action entreprise par cette procédure stockée peut invalider un instantané existant.[ @force_invalidate_snapshot = ] force_invalidate_snapshot Acknowledges that the action taken by this stored procedure may invalidate an existing snapshot. force_invalidate_snapshot est un bit, avec 0comme valeur par défaut.force_invalidate_snapshot is a bit, with a default of 0.

  • 0 indique que les modifications apportées à l’article n’entraînent pas la non-validité de l’instantané.0 specifies that changes to the article do not cause the snapshot to be invalid. Si la procédure stockée détecte que la modification requiert un nouvel instantané, une erreur se produit et aucune modification n'est effectuée.If the stored procedure detects that the change does require a new snapshot, an error occurs and no changes are made.
  • 1 indique que les modifications apportées à l’article peuvent entraîner la non-validité de l’instantané.1 specifies that changes to the article may cause the snapshot to be invalid. Si certains abonnements existants nécessitent un nouvel instantané, cette valeur autorise le marquage de l'instantané existant comme obsolète, et la génération d'un nouvel instantané.If there are existing subscriptions that would require a new snapshot, this value gives permission for the existing snapshot to be marked as obsolete and a new snapshot generated.
    Consultez la section Remarques pour connaître les propriétés dont la modification nécessite la génération d'un nouvel instantané.See the Remarks section for the properties that, when changed, require the generation of a new snapshot.

[ @force_reinit_subscription = ] force_reinit_subscription[@force_reinit_subscription = ] force_reinit_subscription
Confirme que l’action entreprise par cette procédure stockée peut nécessiter la réinitialisation des abonnements existants.Acknowledges that the action taken by this stored procedure may require existing subscriptions to be reinitialized. force_reinit_subscription est un bit avec 0comme valeur par défaut.force_reinit_subscription is a bit with a default of 0.

  • 0 indique que les modifications apportées à l’article n’entraînent pas la réinitialisation de l’abonnement.0 specifies that changes to the article do not cause the subscription to be reinitialized. Si la procédure stockée détecte que la modification nécessite la réinitialisation des abonnements existants, une erreur se produit et aucune modification n'est effectuée.If the stored procedure detects that the change would require existing subscriptions to be reinitialized, an error occurs and no changes are made.
  • 1 indique que les modifications apportées à l’article entraînent la réinitialisation de l’abonnement existant et accorde l’autorisation de réinitialisation de l’abonnement.1 specifies that changes to the article cause the existing subscription to be reinitialized, and gives permission for the subscription reinitialization to occur.

[ @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 utilisé lors de la modification SQL ServerSQL Server des propriétés d’un article sur un serveur de publication.publisher should not be used when changing article properties on 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_changepublication est utilisé dans la réplication d’instantané et la réplication transactionnelle.sp_changepublication is used in snapshot replication and transactional replication.

Après avoir modifié l’une des propriétés suivantes, vous devez générer un nouvel instantané, et vous devez spécifier la valeur 1 pour le paramètre force_invalidate_snapshot .After changing any of the following properties, you must generate a new snapshot, and you must specify a value of 1 for the force_invalidate_snapshot parameter.

  • alt_snapshot_folderalt_snapshot_folder
  • compress_snapshotcompress_snapshot
  • enabled_for_het_subenabled_for_het_sub
  • ftp_addressftp_address
  • ftp_loginftp_login
  • ftp_passwordftp_password
  • ftp_portftp_port
  • ftp_subdirectoryftp_subdirectory
  • post_snapshot_scriptpost_snapshot_script
  • pre_snapshot_scriptpre_snapshot_script
  • snapshot_in_defaultfoldersnapshot_in_defaultfolder
  • sync_modesync_mode

Pour répertorier les objets de publication dans le Active Directory à l’aide SQL ServerSQL Server du paramètre publish_to_Active_Directory, l’objet doit déjà être créé dans le Active Directory.To list publication objects in the Active Directory using the publish_to_active_directory parameter, the SQL ServerSQL Server object must already be created in the Active Directory.

Impact de la synchronisation immédiateImpact of immediate sync

Lorsque la synchronisation immédiate est activée, toutes les modifications apportées au journal sont suivies immédiatement après la génération de l’instantané initial, même s’il n’y a pas d’abonnements.When immediate sync is on, all changes in the log are tracked immediately after the initial snapshot is generated even if there are no subscriptions. Les modifications journalisées sont utilisées quand un client utilise la sauvegarde pour ajouter un nouveau nœud homologue.Logged changes are used when a customer is using backup to add a new peer node. Une fois la sauvegarde restaurée, l’homologue est synchronisé avec toute autre modification qui se produit après la sauvegarde.After the backup is restored, the peer is synched with any other changes occurring after the backup was taken. Étant donné que les commandes sont suivies dans la base de données de distribution, la logique de synchronisation peut examiner le LSN de la dernière sauvegarde et l’utiliser comme point de départ, sachant que la commande est disponible si la sauvegarde a été effectuée au cours de la période de rétention maximale.Since the commands are tracked in the distribution database, the synchronization logic can look at the last backed up LSN and use this as a starting point, knowing that the command is available if the backup was taken within the max retention period. (La valeur par défaut pour la période de rétention minimale est 0 h et la période de rétention maximale est de 24 heures.)(The default value for the min retention period is 0 hrs and max retention period is 24 hrs.)

Lorsque la synchronisation immédiate est désactivée, les modifications sont conservées au moins pendant la période de rétention minimale et nettoyées immédiatement pour toutes les transactions déjà répliquées.When immediate sync is off, changes are kept at least the min retention period and cleaned up immediately for all the transactions that are already replicated. Si la synchronisation immédiate est désactivée et configurée avec la période de rétention par défaut, il est probable que les modifications nécessaires après la sauvegarde aient été nettoyées et que le nouveau nœud homologue ne soit pas correctement initialisé.If immediate sync is off and configured with the default retention period, it is likely that the required changes after the backup was taken were cleaned up and the new peer node will not be initialized properly. La seule option conssite à suspendre la topologie.The only option left is to quiesce the topology. L'activation de la synchronisation immédiate offre davantage de flexibilité et est le paramètre recommandé pour la réplication P2P.Setting immediate sync to on provides greater flexibility and is the recommended setting for P2P replication.

ExempleExample

DECLARE @publication AS sysname
SET @publication = N'AdvWorksProductTran' 

-- Turn off DDL replication for the transactional publication.
USE [AdventureWorks2012]
EXEC sp_changepublication 
  @publication = @publication, 
  @property = N'replicate_ddl', 
  @value = 0
GO

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

Voir aussiSee Also

Afficher et modifier les propriétés d’une publication View and Modify Publication Properties
Changer les propriétés des publications et des articles Change Publication and Article Properties
sp_addpublication (Transact-SQL) sp_addpublication (Transact-SQL)
sp_droppublication (Transact-SQL) sp_droppublication (Transact-SQL)
sp_helppublication (Transact-SQL) sp_helppublication (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)Replication Stored Procedures (Transact-SQL)