sp_helpmergepublication (Transact-SQL)sp_helpmergepublication (Transact-SQL)

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Renvoie des informations sur une publication de fusion.Returns information about a merge 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_helpmergepublication [ [ @publication = ] 'publication' ]  
    [ , [ @found = ] 'found' OUTPUT ]  
    [ , [ @publication_id = ] 'publication_id' OUTPUT ]  
    [ , [ @reserved = ] 'reserved' ]  
    [ , [ @publisher = ] 'publisher' ]  
    [ , [ @publisher_db = ] 'publisher_db' ]  

ArgumentsArguments

[ @publication = ] ' publication '[ @publication**=** ] 'publication'
Nom de la publication.The name of the publication. publicationest sysname, avec une valeur par défaut % , qui retourne des informations sur toutes les publications de fusion dans la base de données actuelle.publicationis sysname, with a default of %, which returns information about all merge publications in the current database.

[ @found = ] 'trouvé' sortie[ @found**=** ] 'found' OUTPUT
Indicateur désignant les lignes retournées.A flag to indicate returning rows. trouvéest int d’un paramètre OUTPUT, avec NULL comme valeur par défaut.foundis int and an OUTPUT parameter, with a default of NULL. 1 indique la publication a été trouvée.1 indicates the publication is found. 0 indique que la publication est introuvable.0 indicates the publication is not found.

[ @publication_id = ] 'publication_id' sortie[ @publication_id**=**] 'publication_id' OUTPUT
Numéro d'identification de la publication.The publication identification number. id_de_la_publication est uniqueidentifier d’un paramètre OUTPUT, avec NULL comme valeur par défaut.publication_id is uniqueidentifier and an OUTPUT parameter, with a default of NULL.

[ @reserved = ] 'réservé'[ @reserved**=**] 'reserved'
Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed. réservé est nvarchar (20) , avec NULL comme valeur par défaut.reserved is nvarchar(20), with a default of NULL.

[ @publisher = ] 'publisher'[ @publisher**=** ] 'publisher'
Le nom du serveur de publication.The name of the Publisher. serveur de publication est sysname, avec NULL comme valeur par défaut.publisher is sysname, with a default of NULL.

[@publisher_db = ] 'publisher_db'[@publisher_db**=** ] 'publisher_db'
Le nom de la base de données de publication.The name of the publication database. publisher_db est sysname, avec NULL comme valeur par défaut.publisher_db is sysname, with a default of NULL.

Jeux de résultatsResult Sets

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
idid intint Numéro séquentiel de la publication dans la liste de l'ensemble de résultats.Sequential order of the publication in the result set list.
namename sysnamesysname Nom de la publication.Name of the publication.
descriptiondescription nvarchar(255)nvarchar(255) Description de la publication.Description of the publication.
statusstatus tinyinttinyint Indique quand les données de publication sont disponibles.Indicates when publication data is available.
retentionretention Intint Temps nécessaire pour enregistrer les métadonnées relatives aux modifications des articles dans la publication.Amount of time to save metadata about changes for articles in the publication. Les unités utilisées pour cette période peuvent être des jours, des semaines, des mois ou des années.The units for this time period can be days, weeks, months, or years. Pour plus d'informations sur ces unités, consultez la colonne retention_period_unit.For information about units, see the retention_period_unit column.
sync_modesync_mode tinyinttinyint Mode de synchronisation de cette publication :Synchronization mode of this publication:

0 = programme de copie en bloc natif (bcp utilitaire)0 = Native bulk copy program (bcp utility)

1 = copie en bloc de caractères1 = Character bulk copy
allow_pushallow_push Intint Détermine si des abonnements par envoi de données (push) peuvent être créés pour la publication concernée.Determines whether push subscriptions can be created for the given publication. 0 signifie qu’un abonnement envoyé n’est pas autorisé.0 means that a push subscription is not allowed.
allow_pullallow_pull intint Détermine si des abonnements par extraction de données (pull) peuvent être créés pour la publication concernée.Determines whether pull subscriptions can be created for the given publication. 0 signifie qu’un abonnement par extraction n’est pas autorisé.0 means that a pull subscription is not allowed.
allow_anonymousallow_anonymous intint Détermine si des abonnements anonymes peuvent être créés pour la publication concernée.Determines whether anonymous subscriptions can be created for the given publication. 0 signifie qu’un abonnement anonyme n’est pas autorisé.0 means that an anonymous subscription is not allowed.
centralized_conflictscentralized_conflicts Intint Détermine si les enregistrements en conflit sont stockés sur le serveur de publication donné :Determines whether conflict records are stored on the given Publisher:

0 = les enregistrements en conflit sont stockés sur le serveur de publication et sur l’abonné qui a provoqué le conflit.0 = conflict records are stored at both the publisher and at the subscriber that caused the conflict.

1 = tous les enregistrements en conflit sont stockés sur le serveur de publication.1 = all conflict records are stored at the Publisher.
prioritypriority float(8)float(8) Priorité de l'abonnement en boucle.Priority of the loop-back subscription.
snapshot_readysnapshot_ready tinyinttinyint Indique si l'instantané de cette publication est prêt :Indicates whether the snapshot of this publication is ready:

0 = instantané est prêt à être utilisé.0 = Snapshot is ready for use.

1 = instantané n’est pas prêt à être utilisé.1 = Snapshot is not ready for use.
publication_typepublication_type intint Type de publication :Type of publication:

0 = instantané.0 = Snapshot.

1 = transactionnelle.1 = Transactional.

2 = fusion.2 = Merge.
pubidpubid uniqueidentifieruniqueidentifier Identificateur unique de la publication.Unique identifier of this publication.
snapshot_jobidsnapshot_jobid binary(16)binary(16) ID de travail de l'Agent d'instantané.Job ID of the Snapshot Agent. Pour obtenir l’entrée du travail d’instantané dans le sysjobs (table système), vous devez convertir cette valeur hexadécimale à uniqueidentifier.To obtain the entry for the snapshot job in the sysjobs system table, you must convert this hexadecimal value to uniqueidentifier.
enabled_for_internetenabled_for_internet intint Détermine si la publication est activée pour Internet.Determines whether the publication is enabled for the Internet. Si 1, les fichiers de synchronisation pour la publication sont placés dans le C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp directory.If 1, the synchronization files for the publication are put into the C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp directory. L'utilisateur doit créer le répertoire FTP (File Transfer Protocol).The user must create the File Transfer Protocol (FTP) directory. Si 0, la publication n’est pas activée pour l’accès Internet.If 0, the publication is not enabled for Internet access.
dynamic_filterdynamic_filter Intint Indique si un filtre de lignes paramétrable est utilisé.Indicates shether a parameterized row filter is used. 0 signifie un filtre de lignes paramétrable n’est pas utilisé.0 means a parameterized row filter is not used.
has_subscriptionhas_subscription bitbit Indique si la publication comporte des abonnements.Indicates whether the publication has any subscriptions. 0 signifie qu’il n’y a actuellement aucun abonnement à cette publication.0 means there are currently no subscriptions to this publication.
snapshot_in_default_foldersnapshot_in_default_folder bitbit Spécifie si les fichiers d’instantanés sont stockés dans le dossier par défaut.Specifies if the snapshot files are stored in the default folder.

Si 1, vous trouverez les fichiers d’instantanés dans le dossier par défaut.If 1, snapshot files can be found in the default folder.

Si 0, fichiers d’instantané sont stockés dans l’emplacement secondaire spécifié par alt_snapshot_folder.If 0, snapshot files are stored in the alternate location specified by alt_snapshot_folder. Les emplacements secondaires peuvent se trouver sur un autre serveur, un lecteur réseau ou un support amovible (tel qu'un CD-ROM ou des disques amovibles).Alternate locations can be on another server, on a network drive, or on a removable media (such as CD-ROM or removable disks). Vous pouvez également enregistrer les fichiers d'instantané sur un site FTP, pour permettre à l'Abonné de les extraire plus tard.You can also save the snapshot files to a FTP site, for retrieval by the Subscriber at a later time.

Remarque : Ce paramètre peut avoir la valeur true et néanmoins avoir un emplacement le alt_snapshot_folder paramètre.Note: This parameter can be true and still have a location in the alt_snapshot_folder parameter. Cette combinaison spécifie que les fichiers d'instantané sont stockés à la fois dans l'emplacement par défaut et dans l'emplacement secondaire.That combination specifies that the snapshot files are stored in both the default and alternate locations.
alt_snapshot_folderalt_snapshot_folder nvarchar(255)nvarchar(255) Indique l'emplacement du dossier de remplacement pour l'instantané.Specifies the location of the alternate folder for the snapshot.
pre_snapshot_scriptpre_snapshot_script nvarchar(255)nvarchar(255) Spécifie un pointeur vers un .sql scripts de fichier que l’Agent de fusion s’exécute avant tout de l’objet répliqué lors de l’application de l’instantané sur l’abonné.Specifies a pointer to an .sql file that the Merge Agent runs before any of the replicated object scripts when applying the snapshot at a Subscriber.
post_snapshot_scriptpost_snapshot_script nvarchar(255)nvarchar(255) Spécifie un pointeur vers un .sql fichier que l’Agent de fusion s’exécute après toutes les autres scripts et objet répliqués données ont été appliquées lors d’une synchronisation initiale.Specifies a pointer to an .sql file that the Merge Agent runs after all the other replicated object scripts and data have been applied during an initial synchronization.
compress_snapshotcompress_snapshot bitbit Spécifie que l’instantané qui est écrite dans le alt_snapshot_folder emplacement est compressé dans le MicrosoftMicrosoft format CAB.Specifies that the snapshot that is written to the alt_snapshot_folder location is compressed into the MicrosoftMicrosoft CAB format.
ftp_addressftp_address sysnamesysname Adresse réseau du service FTP du serveur de distribution.Is the network address of the FTP service for the Distributor. Spécifie l'emplacement à partir duquel l'Agent fusion peut extraire les fichiers d'instantané de la publication.Specifies where publication snapshot files are located for the Merge Agent to pick up.
ftp_portftp_port Intint Numéro de port du service FTP du serveur de distribution.Is the port number of the FTP service for the Distributor. ftp_port a une valeur par défaut de 21.ftp_port has a default of 21. Spécifie l'emplacement où l'Agent de fusion peut accéder aux fichiers d'instantané de la publication.Specifies where the publication snapshot files are located for the Merge Agent to pick up.
ftp_subdirectoryftp_subdirectory nvarchar(255)nvarchar(255) Spécifie l'emplacement où l'Agent de fusion peut accéder aux fichiers d'instantanés lorsque l'instantané est envoyé via FTP.Specifies where the snapshot files are available for the Merge Agent to pick up when the snapshot is delivered using FTP.
ftp_loginftp_login sysnamesysname Le nom d’utilisateur est utilisé pour se connecter au service FTP.Is the username used to connect to the FTP service.
conflict_retentionconflict_retention Intint Indique la période de rétention, en jours, pendant laquelle les conflits sont conservés.Specifies the retention period, in days, for which conflicts are retained. Au terme du nombre de jours spécifié, la ligne en conflit est purgée de la table des conflits.After the specified number of days has passed, the conflict row is purged from the conflict table.
keep_partition_changeskeep_partition_changes intint Indique si l'optimisation de la synchronisation intervient pour cette publication.Specifies whether synchronization optimization is occurring for this publication. keep_partition_changes a une valeur par défaut de 0.keep_partition_changes has a default of 0. La valeur 0 signifie que la synchronisation n’est pas optimisée, et les partitions envoyées à tous les abonnés sont vérifiées lors de la modification des données dans une partition.A value of 0 means that synchronization is not optimized, and the partitions sent to all Subscribers are verified when data changes in a partition.

1 signifie que la synchronisation est optimisée et seuls les abonnés ayant des lignes dans la partition modifiée sont concernés.1 means that synchronization is optimized, and only Subscribers having rows in the changed partition are affected.

Remarque : Par défaut, les publications de fusion utilisent des partitions précalculées, qui fournit un meilleur niveau d’optimisation que cette option.Note: By default, merge publications use precomputed partitions, which provides a greater degree of optimization than this option. Pour plus d’informations, consultez Parameterized Row Filters et optimiser les performances des filtres paramétrés avec des Partitions précalculées.For more information, see Parameterized Row Filters and Optimize Parameterized Filter Performance with Precomputed Partitions.
allow_subscription_copyallow_subscription_copy Intint Spécifie si la possibilité de copier les bases de données d'abonnement qui s'abonnent à cette publication a été activée.Specifies whether the ability to copy the subscription databases that subscribe to this publication has been enabled. La valeur 0 signifie que la copie n’est pas autorisée.A value of 0 means copying is not allowed.
allow_synctoalternateallow_synctoalternate Intint Spécifie si un partenaire de synchronisation différent est autorisé pour se synchroniser avec le serveur de publication.Specifies whether an alternate synchronization partner is allowed to synchronize with this Publisher. La valeur 0 signifie un partenaire de synchronisation n’est pas autorisé.A value of 0 means a synchronization partner is not allowed.
validate_subscriber_infovalidate_subscriber_info nvarchar(500)nvarchar(500) Donne la liste des fonctions utilisées pour extraire les informations d'Abonné et valider les critères de filtre de lignes paramétrable sur l'Abonné.Lists the functions that are being used to retrieve Subscriber information and validate the parameterized row filtering criteria on the Subscriber. Permet de vérifier la cohérence du partitionnement des informations avec chaque fusion.Assists in verifying that the information is partitioned consistently with each merge.
backward_comp_levelbackward_comp_level Intint Niveau de compatibilité de la base de données. Il peut avoir une des valeurs suivantes :Database compatibility level, and can be one of the following:

90 = SQL Server 2005 (9.x)SQL Server 2005 (9.x)90 = SQL Server 2005 (9.x)SQL Server 2005 (9.x)

90 = SQL Server 2005 (9.x)SQL Server 2005 (9.x) SP190 = SQL Server 2005 (9.x)SQL Server 2005 (9.x) SP1

90 = SQL Server 2005 (9.x)SQL Server 2005 (9.x) SP290 = SQL Server 2005 (9.x)SQL Server 2005 (9.x) SP2

100 = SQL Server 2008SQL Server 2008100 = SQL Server 2008SQL Server 2008
publish_to_activedirectorypublish_to_activedirectory bitbit Spécifie si les informations de publication sont publiées dans Active Directory.Specifies if the publication information is published to Active Directory. La valeur 0 signifie que les informations de publication ne sont pas disponibles à partir d’Active Directory.A value of 0 means the publication information is not available from Active Directory.

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 dans Active Directory.You can no longer add publication information to Active Directory.
max_concurrent_mergemax_concurrent_merge intint Nombre de processus de fusion simultanés.The number of concurrent merge processes. Si 0, il n’existe aucune limite au nombre de processus de fusion simultanés en cours d’exécution à un moment donné.If 0, there is no limit to the number of concurrent merge processes running at any given time.
max_concurrent_dynamic_snapshotsmax_concurrent_dynamic_snapshots intint Nombre maximal de sessions d'instantané filtrée pouvant être exécutées simultanément par rapport à la publication de fusion.The maximum number of concurrent filtered data snapshot sessions that can be running against the merge publication. Si 0, il n’existe aucune limite au nombre maximal de sessions d’instantanés de données filtrées simultanées pouvant s’exécuter simultanément sur la publication à un moment donné.If 0, there is no limit to the maximum number of concurrent filtered data snapshot sessions that can run simultaneously against the publication at any given time.
use_partition_groupsuse_partition_groups intint Détermine si des partitions précalculées sont utilisées.Determines if precomputed partitions are used. La valeur 1 signifie que des partitions précalculées est utilisées.A value of 1 means that precomputed partitions are used.
num_of_articlesnum_of_articles Intint Nombre d'articles dans la publication.Number of articles in the publication.
replicate_ddlreplicate_ddl intint Indique si les modifications de schéma des tables publiées sont répliquées.If schema changes to published tables are replicated. La valeur 1 signifie que les modifications de schéma sont répliquées.A value of 1 means that schema changes are replicated.
publication_numberpublication_number smallintsmallint Numéro affecté à cette publication.Number assigned to this publication.
allow_subscriber_initiated_snapshotallow_subscriber_initiated_snapshot bitbit Détermine si les Abonnés peuvent lancer le processus de génération d'instantané de données filtrées.Determines if Subscribers can initiate the filtered data snapshot generation process. La valeur 1 signifie que les abonnés peuvent initier le processus d’instantané.A value of 1 means that Subscribers can initiate the snapshot process.
allow_web_synchronizationallow_web_synchronization bitbit Détermine si la publication est activée pour la synchronisation Web.Determines if the publication is enabled for Web synchronization. La valeur 1 signifie que la synchronisation Web est activée.A value of 1 means that Web synchronization is enabled.
web_synchronization_urlweb_synchronization_url nvarchar(500)nvarchar(500) URL Internet utilisé pour la synchronisation Web.Internet URL that is used for Web synchronization.
allow_partition_realignmentallow_partition_realignment bitbit Détermine si les suppressions sont envoyées à l'abonné lorsque la modification de la ligne sur le serveur de publication entraîne la modification de sa partition.Determines if deletes are sent to the subscriber when modification of the row on the publisher causes it to change its partition. La valeur 1 signifie que les suppressions sont envoyées à l’abonné.A value of 1 means that deletes are sent to the Subscriber. Pour plus d’informations, consultez sp_addmergepublication (Transact-SQL).For more information, see sp_addmergepublication (Transact-SQL).
retention_period_unitretention_period_unit tinyinttinyint Définit l'unité utilisée lors la définition de la rétention.Defines the unit that is used when defining retention. Cela peut prendre l’une des valeurs suivantes :This can be one of the following values:

0 = jour0 = day

1 = semaine1 = week

2 = mois2 = month

3 = année3 = year
has_downloadonly_articleshas_downloadonly_articles bitbit Indique si des articles qui appartiennent à la publication sont des articles téléchargeables uniquement.Indicates if any articles that belong to the publication are download-only articles. La valeur 1 indique qu’il existe des articles en téléchargement seul.A value of 1 indicates that there are download-only articles.
decentralized_conflictsdecentralized_conflicts Intint Indique si les enregistrements en conflit sont stockés sur l'Abonné qui a généré le conflit.Indicates whether the conflict records are stored at the Subscriber that caused the conflict. La valeur 0 indique que les enregistrements en conflit ne sont pas stockés sur l’abonné.A value of 0 indicates that conflict records are not stored at the Subscriber. La valeur 1 indique que les enregistrements en conflit sont stockés sur l'Abonné.A value of 1 indicates that conflict records are stored at the Subscriber.
generation_leveling_thresholdgeneration_leveling_threshold intint Spécifie le nombre de modifications qui sont contenus dans une génération.Specifies the number of changes that are contained in a generation. Une génération est une collection de modifications qui sont remis à un serveur de publication ou un abonnéA generation is a collection of changes that are delivered to a Publisher or Subscriber
automatic_reinitialization_policyautomatic_reinitialization_policy bitbit Indique si les modifications sont téléchargées depuis l'Abonné avant une réinitialisation automatique.Indicates whether changes are uploaded from the Subscriber before an automatic reinitialization occurs. La valeur 1 indique que les modifications sont téléchargées à partir de l’abonné avant une réinitialisation automatique.A value of 1 indicates that changes are uploaded from the Subscriber before an automatic reinitialization occurs. La valeur 0 indique que des modifications ne sont pas téléchargées avant une réinitialisation automatique.A value of 0 indicates that changes are not uploaded before an automatic reinitialization.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_helpmergepublication est utilisé dans la réplication de fusion.sp_helpmergepublication is used in merge replication.

AutorisationsPermissions

Les membres de la liste d'accès à la publication d'une publication peuvent exécuter sp_helpmergepublication pour cette publication.Members of the publication access list for a publication can execute sp_helpmergepublication for that publication. Les membres du rôle de base de données fixe db_owner de la base de données de publication peuvent exécuter sp_helpmergepublication pour obtenir des informations sur toutes les publications.Members of the db_owner fixed database role on the publication database can execute sp_helpmergepublication for information on all publications.

ExempleExample

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';

USE [AdventureWorks2012]
EXEC sp_helpmergepublication @publication = @publication;
GO

Voir aussiSee Also

Afficher et modifier les propriétés d’une publication View and Modify Publication Properties
sp_addmergepublication (Transact-SQL) sp_addmergepublication (Transact-SQL)
sp_changemergepublication (Transact-SQL) sp_changemergepublication (Transact-SQL)
sp_dropmergepublication (Transact-SQL) sp_dropmergepublication (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)Replication Stored Procedures (Transact-SQL)