sp_helpmergepublication (Transact-SQL)

Renvoie des informations sur une publication de fusion. Cette procédure stockée est exécutée sur la base de données de publication du serveur de publication.

Conventions de syntaxe Transact-SQL

Syntaxe

sp_helpmergepublication [ [ @publication = ] 'publication' ]
    [ , [ @found = ] 'found' OUTPUT ]
    [ , [ @publication_id = ] 'publication_id' OUTPUT ]
    [ , [ @reserved = ] 'reserved' ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @publisher_db = ] 'publisher_db' ]

Arguments

• [ @publication = ] 'publication'
  Nom de la publication. publication est de type sysname, avec la valeur par défaut %, qui retourne des informations sur toutes les publications de fusion dans la base de données actuelle.

• [ @found = ] 'found' OUTPUT
  Indicateur désignant les lignes retournées. foundest int avec NULL comme valeur par défaut. Il s'agit d'un paramètre OUTPUT. 1 indique que la publication a été trouvée. 0 indique que la publication est introuvable.

• [ @publication\_id**=**\] **'**publication_id' OUTPUT
  Numéro d'identification de la publication. publication_id est de type uniqueidentifier, avec NULL comme valeur par défaut. Il s'agit d'un paramètre OUTPUT.

• [ @reserved**=**\] 'reserved'
  Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.reserved est de type nvarchar(20), avec NULL comme valeur par défaut.

• [ @publisher**=** ] 'publisher'
  Nom du serveur de publication. publisher est de type sysname, avec NULL comme valeur par défaut.

• [@publisher_db = ] 'publisher_db'
  Nom de la base de données de publication. L'argument publisher_db est de type sysname avec NULL comme valeur par défaut.

Ensembles de résultats

Nom de la colonne	Type de données	Description
id	int	Numéro séquentiel de la publication dans la liste de l'ensemble de résultats.
name	sysname	Nom de la publication.
description	nvarchar(255)	Description de la publication.
status	tinyint	Indique quand les données de publication sont disponibles.
retention	int	Temps nécessaire pour enregistrer les métadonnées relatives aux modifications des articles dans la publication. Les unités utilisées pour cette période peuvent être des jours, des semaines, des mois ou des années. Pour plus d'informations sur ces unités, consultez la colonne retention_period_unit.
sync_mode	tinyint	Mode de synchronisation de la publication : 0 = Programme natif de copie en bloc (utilitaire bcp ) 1 = Copie en bloc de caractères
allow_push	int	Indique si des abonnements par envoi de données (push) peuvent être créés pour la publication concernée. 0 indique qu'un abonnement par envoi de données (push) n'est pas autorisé.
allow_pull	int	Indique si des abonnements par extraction de données (pull) peuvent être créés pour la publication concernée. 0 indique qu'un abonnement par extraction de données (pull) n'est pas autorisé.
allow_anonymous	int	Indique si des abonnements anonymes peuvent être créés pour la publication concernée. 0 indique qu'un abonnement anonyme n'est pas autorisé.
centralized_conflicts	int	Détermine si les enregistrements en conflit sont stockés sur le serveur de publication donné : 0 = Les enregistrements en conflit sont stockés sur le serveur de publication et sur l'Abonné à l'origine du conflit. 1 = tous les enregistrements en conflit sont stockés sur le serveur de publication.
priority	float(8)	Priorité de l'abonnement en boucle.
snapshot_ready	tinyint	Indique si la capture instantanée de cette publication est prête : 0 = Capture instantanée prête à être utilisée. 1 = Capture instantanée non prête à être utilisée.
publication_type	int	Type de publication : 0 = Capture instantanée 1 = Transactionnelle. 2 = Fusion.
pubid	uniqueidentifier	Identificateur unique de la publication.
snapshot_jobid	binary(16)	ID de travail de l'Agent de capture instantanée. Pour obtenir l'entrée du travail de capture instantanée dans la table système sysjobs, vous devez convertir cette valeur hexadécimale en uniqueidentifier.
enabled_for_internet	int	Détermine si la publication est activée pour Internet. Si la valeur est 1, les fichiers de synchronisation de la publication sont placés dans le répertoire C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp. L'utilisateur doit créer le répertoire FTP (File Transfer Protocol). Si la valeur est 0, la publication n'est pas activée pour l'accès Internet.
dynamic_filter	int	Indique si un filtrage des lignes paramétrable est utilisé. 0 signifie qu'un filtrage des lignes paramétrable n'est pas utilisé.
has_subscription	bit	Indique si la publication autorise les abonnements. 0 signifie que la publication n'a actuellement aucun abonnement.
snapshot_in_default_folder	bit	Indique si les fichiers de capture instantanée sont stockés dans le dossier par défaut. Si la valeur est 1, les fichiers de capture instantanée se trouvent dans le dossier par défaut. Si la valeur est 0, les fichiers de capture instantanée sont stockés dans le dossier de remplacement spécifié par 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). Vous pouvez également enregistrer les fichiers de capture instantanée sur un site FTP, pour permettre à l'Abonné de les extraire plus tard. Remarque Ce paramètre peut avoir la valeur true et disposer encore d'un emplacement dans le paramètre alt_snapshot_folder. Cette combinaison spécifie que les fichiers de capture instantanée sont stockés à la fois dans l'emplacement par défaut et dans l'emplacement secondaire.
alt_snapshot_folder	nvarchar(255)	Spécifie l'emplacement du dossier secondaire de la capture instantanée.
pre_snapshot_script	nvarchar(255)	Spécifie un pointeur vers un fichier .sql que l'Agent de fusion exécute avant les scripts d'objets répliqués lors de l'application de la capture instantanée au niveau de l'Abonné.
post_snapshot_script	nvarchar(255)	Spécifie un pointeur vers un fichier .sql que l'Agent de fusion exécute après que tous les autres scripts et données d'objets répliqués aient été appliqués au cours d'une synchronisation initiale.
compress_snapshot	bit	Spécifie que la capture instantanée écrite à l'emplacement alt_snapshot_folder est compressée au format Microsoft CAB.
ftp_address	sysname	Adresse réseau du service FTP du serveur de distribution. Spécifie l'emplacement à partir duquel l'Agent fusion peut extraire les fichiers de capture instantanée de la publication.
ftp_port	int	Numéro de port du service FTP du serveur de distribution. ftp_port a une valeur par défaut de 21. Spécifie l'emplacement où l'Agent de fusion peut accéder aux fichiers de capture instantanée de la publication.
ftp_subdirectory	nvarchar(255)	Spécifie l'emplacement où l'Agent de fusion peut accéder aux fichiers de capture instantanée lorsque la capture instantanée est envoyée via FTP.
ftp_login	sysname	Nom d'utilisateur utilisé pour la connexion au service FTP.
conflict_retention	int	Indique la période de rétention, en jours, pendant laquelle les conflits sont conservés. Au terme du nombre de jours spécifié, la ligne en conflit est purgée de la table des conflits.
keep_partition_changes	int	Spécifie si la synchronisation est optimisée pour cette publication. keep_partition_changes a la valeur par défaut 0. La valeur 0 indique que la synchronisation n'est pas optimisée et que les partitions envoyées à tous les Abonnés sont vérifiées lorsque les données d'une partition sont modifiées. La valeur 1 indique que la synchronisation est optimisée et que seuls les Abonnés ayant des lignes dans la partition changée sont affectés. Remarque Par défaut, les publications de fusion utilisent des partitions précalculées, ce qui offre un meilleur niveau d'optimisation que cette option. Pour plus d'informations, consultez Filtres de lignes paramétrés et Optimisation des performances des filtres paramétrés avec des partitions précalculées.
allow_subscription_copy	int	Spécifie si la possibilité de copier les bases de données d'abonnement qui s'abonnent à cette publication a été activée. La valeur 0 indique que la copie n'est pas autorisée.
allow_synctoalternate	int	Spécifie si un partenaire de synchronisation différent est autorisé pour se synchroniser avec le serveur de publication. La valeur 0 signifie qu'un partenaire de synchronisation n'est pas autorisé.
validate_subscriber_info	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é. Permet de vérifier la cohérence du partitionnement des informations avec chaque fusion.
backward_comp_level	int	Niveau de compatibilité de la base de données. Peut avoir une des valeurs suivantes : 10 = SQL Server 7.0 20 = SQL Server 7.0 SP1 30 = SQL Server 7.0 SP2 30 = SQL Server 7.0 SP3 30 = SQL Server 7.0 SP4 40 = SQL Server 2000 40 = SQL Server 2000 SP1 40 = SQL Server 2000 SP2 40 = SQL Server 2000 SP3 90 = SQL Server 2005 90 = SQL Server 2005 SP1 90 = SQL Server 2005 SP2 100 = SQL Server 2008
publish_to_activedirectory	bit	Spécifie si les informations de publication sont publiées dans Active Directory. La valeur 0 signifie que les informations de publication ne sont pas disponibles dans Active Directory. Ce paramètre a été désapprouvé et il n'est pris en charge que pour la compatibilité descendante des scripts. Vous ne pouvez plus ajouter d'informations de publication dans Active Directory.
max_concurrent_merge	int	Nombre de processus de fusion simultanés. Si la valeur est 0, cela indique qu'il peut exister un nombre illimité de processus de fusion simultanés à tout instant.
max_concurrent_dynamic_snapshots	int	Nombre maximal de sessions de capture instantanée filtrée pouvant être exécutées simultanément par rapport à la publication de fusion. Si la valeur est 0, il peut exister un nombre illimité de sessions de captures instantanées filtrées simultanées exécutées par rapport à la publication à n'importe quel moment.
use_partition_groups	int	Détermine si des partitions précalculées sont utilisées. La valeur 1 indique que des partitions précalculées sont utilisées.
num_of_articles	int	Nombre d'articles dans la publication.
replicate_ddl	int	Indique si les modifications de schéma des tables publiées sont répliquées. La valeur 1 indique que les modifications de schéma sont répliquées.
publication_number	smallint	Numéro affecté à cette publication.
allow_subscriber_initiated_snapshot	bit	Détermine si les Abonnés peuvent lancer le processus de génération de capture instantanée de données filtrées. La valeur 1 indique que les Abonnés peuvent lancer le processus de capture instantanée.
allow_web_synchronization	bit	Détermine si la publication est activée pour la synchronisation Web. La valeur 1 indique que la synchronisation Web est activée.
web_synchronization_url	nvarchar(500)	URL Internet utilisé pour la synchronisation Web.
allow_partition_realignment	bit	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. La valeur 1 indique que les suppressions sont envoyées à l'Abonné. Pour plus d'informations, consultez sp_addmergepublication (Transact-SQL).
retention_period_unit	tinyint	Définit l'unité utilisée lors la définition de la rétention. Les valeurs possibles sont : 0 = jour 1 = semaine 2 = mois 3 = année
has_downloadonly_articles	bit	Indique si des articles qui appartiennent à la publication sont des articles téléchargeables uniquement. La valeur 1 indique qu'il s'agit d'articles téléchargeables uniquement.
decentralized_conflicts	int	Indique si les enregistrements en conflit sont stockés sur l'Abonné qui a généré le conflit. La valeur 0 indique que les enregistrements en conflit ne sont pas stockés sur l'Abonné qui a généré le conflit. La valeur 1 indique que les enregistrements en conflit sont stockés sur l'Abonné.
generation_leveling_threshold	int	Indique le nombre de modifications contenues dans une génération. Une génération est une collection de modifications remises à un serveur de publication ou à un Abonné. Pour plus d'informations, consultez Comment la réplication de fusion effectue le suivi et l'énumération des modifications.
automatic_reinitialization_policy	bit	Indique si les modifications sont téléchargées depuis l'Abonné avant une réinitialisation automatique. La valeur 1 indique que des modifications sont téléchargées depuis l'Abonné avant une réinitialisation automatique. La valeur 0 indique que des modifications ne sont pas téléchargées avant une réinitialisation automatique.

Valeurs des codes de retour

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

Notes

sp_helpmergepublication est utilisé dans la réplication de fusion.

Autorisations

Les membres de la liste d'accès à la publication d'une publication peuvent exécuter sp_helpmergepublication pour cette 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.

Exemple

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

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

Voir aussi

Tâches

Procédure : afficher et modifier les propriétés de publications (programmation Transact-SQL de la réplication)

Référence

sp_addmergepublication (Transact-SQL)

sp_changemergepublication (Transact-SQL)

sp_dropmergepublication (Transact-SQL)

Procédures stockées de réplication (Transact-SQL)