sp_helpmergepublication (Transact-SQL)

S’applique à :SQL Server

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

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @publication = ] N’publication'

Nom de la publication. @publication est sysname, avec une valeur par défaut %, qui retourne des informations sur toutes les publications de fusion dans la base de données active.

[ @found = ] found OUTPUT

Indicateur permettant d’indiquer le retour de lignes. @found est un paramètre OUTPUT de type int.

  • 1 indique que la composition est trouvée.
  • 0 indique que la composition n’est pas trouvée.

[ @publication_id = ] SORTIE 'publication_id'

Numéro d'identification de la publication. @publication_id est un paramètre OUTPUT de type uniqueidentifier.

[ @reserved = ] N’reserved'

Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

[ @publisher = ] N’publisher'

Nom du serveur de publication. @publisher est sysname, avec la valeur par défaut NULL.

[ @publisher_db = ] N’publisher_db'

Nom de la base de données de publication. @publisher_db est sysname, avec la valeur par défaut NULL.

Jeu 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 cette publication :

0 = Programme de copie en bloc natif (utilitaire bcp )

1 = Copie en bloc de caractères
allow_push int Détermine si des abonnements par envoi de données (push) peuvent être créés pour la publication concernée. 0 signifie qu’un abonnement Push n’est pas autorisé.
allow_pull int Détermine si des abonnements par extraction de données (pull) peuvent être créés pour la publication concernée. 0 signifie qu’un abonnement par extraction n’est pas autorisé.
allow_anonymous int Détermine si des abonnements anonymes peuvent être créés pour la publication concernée. 0 signifie 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 de conflit sont stockés à la fois sur le serveur de publication et sur l’abonné qui a provoqué le conflit.

1 = tous les enregistrements de conflit sont stockés sur le serveur de publication.
priority float(8) Priorité de l'abonnement en boucle.
snapshot_ready tinyint Indique si l'instantané de cette publication est prêt :

0 = La capture instantanée est prête à être utilisée.

1 = L’instantané n’est pas prêt à être utilisé.
publication_type int Type de publication :

0 = Instantané.

1 = Transactionnel.

2 = Fusion.
pubid uniqueidentifier Identificateur unique de la publication.
snapshot_jobid binary(16) ID de travail de l'Agent d'instantané. Pour obtenir l’entrée du travail instantané dans la table système sysjobs, vous devez convertir cette valeur hexadécimale en identificateur unique.
enabled_for_internet int Détermine si la publication est activée pour Internet. Si 1, les fichiers de synchronisation de la publication sont placés dans le C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp répertoire. L'utilisateur doit créer le répertoire FTP (File Transfer Protocol). Si 0la publication n’est pas activée pour l’accès à Internet.
dynamic_filter int Indique si un filtre de lignes paramétrable est utilisé. 0 signifie qu’un filtre de lignes paramétrable n’est pas utilisé.
has_subscription bit Indique si la publication comporte des abonnements. 0 signifie qu’il n’existe actuellement aucun abonnement à cette publication.
snapshot_in_default_folder bit Spécifie si les fichiers instantané sont stockés dans le dossier par défaut.

Si 1, instantané fichiers se trouvent dans le dossier par défaut.

Si 0, instantané fichiers sont stockés dans l’autre emplacement 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 d'instantané sur un site FTP, pour qu'ils soient récupérés ultérieurement par l'Abonné.

Remarque : Ce paramètre peut être vrai et avoir toujours un emplacement dans le alt_snapshot_folder paramètre. 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.
alt_snapshot_folder nvarchar(255) Indique l'emplacement du dossier de remplacement pour l'instantané.
pre_snapshot_script nvarchar(255) Spécifie un pointeur vers un fichier .sql exécuté par le Agent de fusion avant l’un des scripts d’objet répliqués lors de l’application de la instantané sur un Abonné.
post_snapshot_script nvarchar(255) Spécifie un pointeur vers un fichier .sql exécuté par l’Agent de fusion une fois que tous les autres scripts et données d’objet répliqués ont été appliqués pendant une synchronisation initiale.
compress_snapshot bit Spécifie que le instantané écrit à l’emplacement alt_snapshot_folder est compressé dans le format CAB Microsoft.
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 d'instantané de la publication.
ftp_port int Numéro de port du service FTP pour le serveur de distribution. ftp_port a la valeur par défaut 21. Spécifie l'emplacement où l'Agent de fusion peut accéder aux fichiers d'instantané de la publication.
ftp_subdirectory 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.
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 Indique si l'optimisation de la synchronisation intervient pour cette publication. keep_partition_changes a la valeur par défaut 0. Une valeur de 0 signifie 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 changent dans une partition.

1 signifie que la synchronisation est optimisée et que seuls les Abonnés ayant des lignes dans la partition modifiée sont affectés.

Remarque : Par défaut, les publications de fusion utilisent des partitions précomputées, qui fournissent un plus grand degré d’optimisation que cette option. Pour plus d’informations, consultez Filtres paramétrables - Filtres de lignes paramétrables et filtres paramétrables - Optimiser pour les partitions précomputé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 des moyens de 0 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 d’un partenaire de 0 synchronisation n’est pas autorisée.
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 que les informations sont partitionnés de manière cohérente avec chaque fusion.
backward_comp_level int Niveau de compatibilité de la base de données et peut être l’une des valeurs suivantes :

90 = SQL Server 2005 (9.x)

90 = SQL Server 2005 (9.x) SP1

90 = SQL Server 2005 (9.x) SP2

100 = SQL Server 2008 (10.0.x)
publish_to_activedirectory bit Spécifie si les informations de publication sont publiées dans Active Directory. Valeur de signifie que les informations de 0 publication ne sont pas disponibles à partir d’Active Directory.

Ce paramètre est déconseillé et est maintenu 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 0, il n’existe aucune limite au nombre de processus de fusion simultanés en cours d’exécution à un moment donné.
max_concurrent_dynamic_snapshots int Nombre maximal de sessions d'instantané filtrée pouvant être exécutées simultanément par rapport à la publication de fusion. Si 0, il n’existe aucune limite au nombre maximal de données filtrées simultanées instantané sessions qui peuvent s’exécuter simultanément sur la publication à un moment donné.
use_partition_groups int Détermine si des partitions précalculées sont utilisées. Valeur de 1 signifie que les partitions précomputé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. Valeur de signifie que les modifications de 1 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 d'instantané de données filtrées. Valeur de 1 signifie que les Abonnés peuvent lancer le processus de instantané.
allow_web_synchronization bit Détermine si la publication est activée pour la synchronisation Web. Valeur de 1 signifie que la synchronisation web est activée.
web_synchronization_url nvarchar(500) URL Internet utilisé pour la synchronisation Web.
allow_partition_realignment bit Indique si les suppressions sont envoyées à l'abonné lorsque la modification de la ligne sur le serveur de publication amène celui-ci à modifier sa partition. Valeur de 1 signifie 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. Il peut s’agir de l’une des valeurs suivantes :

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. Une valeur indiquant qu’il 1 existe des articles en téléchargement uniquement.
decentralized_conflicts int Indique si les enregistrements en conflit sont stockés sur l'Abonné qui a généré le conflit. Une valeur indiquant 0 que les enregistrements en conflit ne sont pas stockés sur l’Abonné. Une valeur indiquant 1 que les enregistrements en conflit sont stockés sur l’Abonné.
generation_leveling_threshold int Spécifie le nombre de modifications contenues dans une génération. Une génération est une collection de modifications fournies à un serveur de publication ou à un abonné
automatic_reinitialization_policy bit Indique si les modifications sont téléchargées depuis l'Abonné avant une réinitialisation automatique. Une valeur indiquant 1 que les modifications sont chargées à partir de l’Abonné avant qu’une réinitialisation automatique se produise. La valeur 0 indique que les modifications ne sont pas chargées avant une réinitialisation automatique.

Valeurs des codes de retour

0 (réussite) 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 pour une publication peuvent s’exécuter sp_helpmergepublication pour cette publication. Les membres du rôle de base de données fixe db_owner sur la base de données de publication peuvent s’exécuter sp_helpmergepublication pour obtenir des informations sur toutes les publications.

Exemples

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

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