Partager via


sp_changepublication (Transact-SQL)

Modifie les propriétés d'une publication. Cette procédure stockée est exécutée au niveau du serveur de publication dans la base de données de publication.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @publication=] 'publication'
    Nom de la publication. publication est de type sysname, avec la valeur par défaut NULL.

  • [ @property=] 'property'
    Propriété de publication à modifier. property est de type nvarchar(255).

  • [ @value=] 'value'
    Nouvelle valeur de la propriété. value est de type nvarchar(255), avec NULL comme valeur par défaut.

    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.

    Propriété

    Valeur

    Description

    allow_anonymous

    true

    Il est possible de créer des abonnements anonymes pour la publication concernée, et immediate_sync doit également prendre la valeur true. Ne peut pas être modifiée pour les publications d'égal à égal.

     

    false

    Il n'est pas possible de créer des abonnements anonymes pour la publication concernée. Ne peut pas être modifiée pour les publications d'égal à égal.

    allow_initialize_from_backup

    true

    Les abonnés peuvent initialiser un abonnement à cette publication à partir d'une sauvegarde au lieu de le faire à partir d'une capture instantanée initiale. Cette propriété ne peut pas être modifiée pour les publications non-Microsoft SQL Server.

     

    false

    Les abonnés doivent utiliser la capture instantanée initiale. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    allow_partition_switch

    true

    Les instructions ALTER TABLE…SWITCH peuvent être exécutées sur la base de données publiée. Pour plus d'informations, consultez Réplication de tables et d'index partitionnés.

    false

    Les instructions ALTER TABLE…SWITCH ne peuvent pas être exécutées sur la base de données publiée.

    allow_pull

    true

    Indique si des abonnements par extraction de données (pull) sont autorisés pour la publication concernée. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

     

    false

    Les abonnements par extraction de données (pull) ne sont pas autorisés pour la publication concernée. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    allow_push

    true

    Indique si des abonnements par envoi de données (push) sont autorisés pour la publication concernée.

     

    false

    Les abonnements par envoi de données (push) ne sont pas autorisés pour la publication concernée.

    allow_subscription_copy

    true

    Active la possibilité de copier les bases de données qui sont abonnées à la publication. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

     

    false

    Désactive la possibilité de copier les bases de données qui sont abonnées à la publication. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    alt_snapshot_folder

     

    Emplacement du dossier de remplacement pour la capture instantanée.

    centralized_conflicts

    true

    Les enregistrements en conflit sont stockés sur le serveur de publication. Ne peut être modifiée qu'en l'absence d'abonnements actifs. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

     

    false

    Les enregistrements en conflit sont stockés à la fois sur le serveur de publication et sur l'Abonné ayant généré le conflit. Ne peut être modifiée qu'en l'absence d'abonnements actifs. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    compress_snapshot

    true

    Une capture instantanée dans un dossier de captures instantanées de remplacement est compressé au format de fichier .cab. La capture instantanée se trouvant dans le dossier par défaut ne peut pas être compressée.

     

    false

    La capture instantanée n'est pas compressée ; c'est le comportement par défaut de la réplication.

    conflict_policy

    pub wins

    Politique de résolution des conflits de mise à jour des Abonnés dans laquelle le serveur de publication l'emporte dans le conflit. Cette propriété ne peut être modifiée qu'en l'absence d'abonnements actifs. Pas de prise en charge pour les serveurs de publication Oracle.

     

    sub reinit

    Pour la mise à jour des Abonnés, en cas de conflit, l'abonnement doit être réinitialisé. Cette propriété ne peut être modifiée qu'en l'absence d'abonnements actifs. Pas de prise en charge pour les serveurs de publication Oracle.

     

    sub wins

    Politique de résolution des conflits de mise à jour des Abonnés dans laquelle l'Abonné l'emporte dans le conflit. Cette propriété ne peut être modifiée qu'en l'absence d'abonnements actifs. Pas de prise en charge pour les serveurs de publication Oracle.

    conflict_retention

     

    Nombre de type int, exprimé en jours, qui spécifie la période de rétention des conflits. La rétention par défaut est de 14 jours. 0 signifie qu'aucun nettoyage de conflit n'est nécessaire. Pas de prise en charge pour les serveurs de publication Oracle.

    description

     

    Entrée facultative décrivant la publication.

    enabled_for_het_sub

    true

    Permet à la publication de prendre en charge des abonnés non-SQL Server. enabled_for_het_sub ne peut pas être modifié s'il existe des abonnements à la publication. Il peut être nécessaire d'exécuter sp_changepublication (Transact-SQL) pour se conformer aux conditions requises ci-dessous avant de définir enabled_for_het_sub sur TRUE :

    • allow_queued_tran doit avoir la valeur false.

    • allow_sync_tran doit avoir la valeur false.

    Si vous modifiez enabled_for_het_sub pour lui donner la valeur true, vous risquez de modifier des paramètres existants de la publication. Pour plus d'informations, consultez Abonnés non-SQL Server. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    false

    La publication ne prend pas en charge les Abonnés non-SQL Server. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    enabled_for_internet

    true

    La publication est activée pour Internet, et le protocole FTP peut être utilisé pour le transfert des fichiers de capture instantanée vers un abonné. Les fichiers de synchronisation de la publication sont placés dans le répertoire suivant : C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\ftp. ftp_address ne peut pas être NULL. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

     

    false

    La publication n'est pas activée pour Internet. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    enabled_for_p2p

    true

    La publication prend en charge la réplication d'égal à égal. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    Pour définir enabled_for_p2p sur true, les restrictions suivantes s'appliquent :

    • allow_anonymous doit avoir la valeur false.

    • allow_dts doit avoir la valeur false.

    • allow_initialize_from_backup doit avoir la valeur true.

    • allow_queued_tran doit avoir la valeur false.

    • allow_sync_tran doit avoir la valeur false.

    • enabled_for_het_sub doit avoir la valeur false.

    • independent_agent doit avoir la valeur true.

    • repl_freq doit avoir la valeur continuous.

    • replicate_ddl doit avoir la valeur 1.

    false

    La publication ne prend pas en charge la réplication d'égal à égal. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    ftp_address

     

    Emplacement accessible par FTP des fichiers de capture instantanée de la publication. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    ftp_login

     

    Nom d'utilisateur permettant la connexion au service FTP ; la valeur ANONYMOUS est autorisée. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    ftp_password

     

    Mot de passe associé au nom d'utilisateur utilisé pour la connexion au service FTP. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    ftp_port

     

    Numéro de port du service FTP du serveur de distribution. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    ftp_subdirectory

     

    Indique l'emplacement où sont créés les fichiers de captures instantanées si la publication prend en charge la propagation de captures instantanées par FTP. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

    immediate_sync

    true

    Les fichiers de synchronisation sont créés ou recréés à chaque exécution de l'Agent de capture instantanée. Les Abonnés peuvent obtenir les fichiers de synchronisation immédiatement après l'abonnement si l'Agent de capture instantanée a été exécuté une fois avant l'abonnement. 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 de capture instantanée. L'argument independent_agent doit avoir la valeur true.

     

    false

    Les fichiers de synchronisation sont créés uniquement lors de nouveaux abonnements. 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 de capture instantanée.

    independent_agent

    true

    La publication a son propre Agent de distribution dédié.

     

    false

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

    p2p_continue_onconflict

    true

    L'Agent de distribution continue à traiter les modifications lorsqu'un conflit est détecté.

    AttentionAttention
    Nous vous recommandons d'utiliser la valeur par défaut FALSE. Lorsque cette option a la valeur TRUE, l'Agent de distribution tente de converger les données dans la topologie en appliquant la ligne en conflit du nœud doté de l'ID d'appelant le plus élevé. Cette méthode ne garantit pas la convergence. Vous devez vous assurer que la topologie est cohérente après la détection d'un conflit. Pour plus d'informations, consultez « Gestion des conflits » dans Détection de conflit dans la réplication d'égal à égal.

    false

    L'Agent de distribution cesse de traiter les modifications lorsqu'un conflit est détecté.

    post_snapshot_script

     

    Spécifie l'emplacement d'un fichier de script Transact-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.

    pre_snapshot_script

     

    Spécifie l'emplacement d'un fichier de script Transact-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.

    publish_to_ActiveDirectory

    true

    Ce paramètre a été abandonné et n'est pris en charge que pour la compatibilité descendante des scripts. Vous ne pouvez plus ajouter d'informations de publication dans Microsoft Active Directory.

     

    false

    Supprime les informations de publication d'Active Directory.

    queue_type

    sql

    Utilise SQL Server pour stocker les transactions. Cette propriété ne peut être modifiée qu'en l'absence d'abonnements actifs.

    RemarqueRemarque
    La prise en charge de l'utilisation de Microsoft Message Queuing a été arrêtée. Si vous spécifiez la valeur msmq pour value, une erreur se produit.

    repl_freq

    continuous

    Publie la sortie de toutes les transactions enregistrées dans le journal.

     

    snapshot

    Publie uniquement les événements de synchronisation planifiés.

    replicate_ddl

    1

    Les instructions DDL (Data Definition Language) exécutées sur le serveur de publication sont répliquées. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server.

     

    0

    Les instructions DDL ne sont pas répliquées. Cette propriété ne peut pas être modifiée pour les publications non-SQL Server. 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.

    replicate_partition_switch

    true

    Les instructions ALTER TABLE…SWITCH exécutées sur la base de données publiée doivent être répliquées sur les Abonnés. Cette option est valide uniquement si allow_partition_switch a la valeur TRUE. Pour plus d'informations, consultez Réplication de tables et d'index partitionnés.

    false

    Les instructions ALTER TABLE…SWITCH ne doivent pas être répliquées sur les Abonnés.

    retention

     

    Nombre de type int représentant la période de rétention de l'activité d'abonnement, exprimée en heures. Si un abonnement n'est pas actif durant la période de rétention, il est supprimé.

    snapshot_in_defaultfolder

    true

    Les fichiers de capture instantanée sont stockés dans le dossier de captures instantanées par défaut. Si la valeur de alt_snapshot_folderest également spécifiée, les fichiers de capture instantanée sont stockés dans les emplacements par défaut et de remplacement.

     

    false

    Les fichiers de capture instantanée sont stockés dans le dossier de remplacement spécifié par alt_snapshot_folder.

    status

    active

    Les données de publication sont disponibles immédiatement pour les Abonnés lors de la création de la publication. Pas de prise en charge pour les serveurs de publication Oracle.

     

    inactive

    Les données de publication ne sont pas disponibles pour les Abonnés lors de la création de la publication. Pas de prise en charge pour les serveurs de publication Oracle.

    sync_method

    native

    Utilise la copie en bloc en mode natif de toutes les tables lors de la synchronisation des abonnements.

     

    character

    Utilise la copie en bloc en mode caractère de toutes les tables lors de la synchronisation des abonnements.

     

    concurrent

    Utilise la copie en bloc en mode natif de toutes les tables, mais ne verrouille pas les tables au cours de la capture instantanée. Non valide pour la réplication de capture instantanée.

     

    concurrent_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 la capture instantanée. Non valide pour la réplication de capture instantanée.

    taskid

     

    Cette propriété a été abandonnée et n'est plus prise en charge.

    NULL (valeur par défaut)

     

    Renvoie la liste des valeurs prises en charge pour property.

  • [ @force_invalidate_snapshot = ] force_invalidate_snapshot
    Signale que l'action entreprise par cette procédure stockée peut invalider une capture instantanée existante. force_invalidate_snapshot est de type bit, avec 0 comme valeur par défaut.

    0 indique que les modifications apportées à l'article ne doivent pas invalider la capture instantanée. Si la procédure stockée détecte que la modification requiert une nouvelle capture instantanée, une erreur est générée et aucune modification n'est effectuée.

    1 indique que les modifications apportées à l'article peuvent invalider la capture instantanée. Si certains abonnements existants nécessitent une nouvelle capture instantanée, cette valeur autorise le marquage de la capture instantanée existante comme obsolète, et la génération d'une nouvelle capture instantanée.

    Consultez la section Remarques pour connaître les propriétés dont la modification nécessite la génération d'une nouvelle capture instantanée.

  • [@force_reinit_subscription = ] force_reinit_subscription
    Signale que l'action entreprise par cette procédure stockée peut nécessiter la réinitialisation des abonnements existants. force_reinit_subscription est de type bit, avec 0 comme valeur par défaut.

    0 indique que les modifications apportées à l'article ne doivent pas provoquer la réinitialisation de l'abonnement. Si la procédure stockée détecte que la modification requiert la réinitialisation des abonnements existants, une erreur est générée et aucune modification n'est effectuée.

    1 indique que les modifications apportées à l'article entraînent la réinitialisation d'abonnements existants, et autorise la réinitialisation de ces abonnements.

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

    Notes

    publisher ne doit pas être utilisé lors de la modification des propriétés d'article sur un serveur de publication SQL Server.

Valeurs des codes renvoyés

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

Notes

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

Le changement de l'une quelconque des propriétés ci-dessous nécessite la génération d'une nouvelle capture instantanée, et vous devez spécifier une valeur de 1 pour le paramètre force_invalidate_snapshot.

  • alt_snapshot_folder

  • compress_snapshot

  • enabled_for_het_sub

  • ftp_address

  • ftp_login

  • ftp_password

  • ftp_port

  • ftp_subdirectory

  • post_snapshot_script

  • pre_snapshot_script

  • snapshot_in_defaultfolder

  • sync_mode

Les objets de publication figurant dans l'annuaire Active Directory ne peuvent être affichés à l'aide du paramètre @publish_to_Active_Directory que si l'objet SQL Server est déjà créé dans l'annuaire.

Exemple

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

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

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