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.
1indique que la composition est trouvée.0indique 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 d’instantané 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 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 d’instantané sont stockés dans le dossier par défaut. Si 1, les fichiers d’instantané se trouvent dans le dossier par défaut.Si 0, les fichiers d’instantané sont stockés dans l’autre emplacement spécifié par alt_snapshot_folder. D’autres emplacements peuvent se trouver sur un autre serveur, sur un lecteur réseau ou sur un support amovible (par exemple, 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 que le Agent de fusion s’exécute avant l’un des scripts d’objet répliqués lors de l’application de l’instantané sur un Abonné. |
post_snapshot_script |
nvarchar(255) | Spécifie un pointeur vers un fichier .sql que le Agent de fusion s’exécute une fois que tous les autres scripts d’objet répliqués et les données ont été appliqués pendant une synchronisation initiale. |
compress_snapshot |
bit | Spécifie que l’instantané écrit à l’emplacement alt_snapshot_folder est compressé au 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) SP190 = SQL Server 2005 (9.x) SP2100 = 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 sessions d’instantanés de données filtrées simultanées 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. Une valeur de 1 signifie que les Abonnés peuvent lancer le processus d’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 = jour1 = semaine2 = mois3 = 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) or 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