sp_helpmergepublication (Transact-SQL)

Mis à jour : 12 décembre 2006

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 la syntaxe de 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 renvoie des informations sur toutes les publications de fusion dans la base de données actuelle.

• [ @found= ] **'found'**OUTPUT
  Indicateur qui spécifie les lignes renvoyées. found est de type int et un paramètre OUTPUT, avec la valeur par défaut NULL. 1 indique que la publication est trouvée. 0 indique que la publication n'est pas trouvée.

• [ @publication_id=] 'publication_id' OUTPUT
  Numéro d'identification de la publication. publication_id est de type uniqueidentifier et un paramètre OUTPUT, avec la valeur par défaut NULL.

• [ @reserved=] 'reserved'
  Réservé pour une utilisation future. description est de type nvarchar(20), avec la valeur par défaut NULL.

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

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

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.

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

Moment où les données de publication sont disponibles.

retention

int

Volume des modifications à enregistrer pour la publication donnée (en jours).

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éées 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 donnée. 0 indique qu'un abonnement anonyme n'est pas autorisé.

centralized_conflicts

int

Indique 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é qui a provoqué le 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 identificateur unique.

enabled_for_internet

int

Indique 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 a des abonnements. 0 signifie que la publication n'a 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 un emplacement secondaire 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 être égal à 1 (vrai) et un emplacement peut être en même temps spécifié 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 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 de capture instantanée de la publication.

ftp_port

int

Numéro de port du service FTP du serveur de distribution. La valeur par défaut de ftp_port est 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 la publication. keep_partition_changes a la valeur par défaut 0.

0 indique que l'optimisation 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 changent.

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. 0 indique que la copie n'est pas permise.

allow_synctoalternate

int

Spécifie si un partenaire de synchronisation différent est autorisé pour se synchroniser avec le serveur de publication. 0 indique qu'aucun partenaire de synchronisation n'est 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 filtrage des 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 = Microsoft SQL Server 7.0

20 = SQL Server 7.0 Service Pack 1

30 = SQL Server 7.0 Service Pack 2

35 = SQL Server 7.0 Service Pack 3

40 = Microsoft SQL Server 2000

50 = SQL Server 2000 Service Pack 1

60 = SQL Server 2000 Service Pack 3

90 = Microsoft SQL Server 2005

publish_to_activedirectory

bit

Spécifie si les informations de publication sont publiées dans Microsoft Active Directory. 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 des informations de publication à Microsoft Active Directory.

max_concurrent_merge

int

Nombre de processus de fusion simultanés. La valeur 0 de cette propriété indique qu'il peut exister un nombre illimité de processus de fusion simultanés à n'importe quel moment.

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

Indique si des partitions précalculées sont utilisées. 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. 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

Indique si les Abonnés peuvent lancer le processus de génération de capture instantanée de données filtrées. 1 indique que les Abonnés peuvent lancer le processus de capture instantanée.

allow_web_synchronization

bit

Indique si la publication est activée pour la synchronisation Web. 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

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

1 indique que les suppressions sont envoyées à l'Abonné.

0 indique que les suppressions ne sont pas envoyées. Pour plus d'informations, consultez sp_addmergepublication

retention_period_unit

tinyint

Définit l'unité utilisée lors la définition de la rétention. Peut avoir 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. 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 :

0 = Les enregistrements en conflit ne sont pas stockés au niveau de l'Abonné.

1 = Les enregistrements en conflit sont stockés au niveau de 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.

1 = les modifications sont téléchargées depuis l'Abonné avant une réinitialisation automatique.

0 = les modifications ne sont pas téléchargées avant une réinitialisation automatique.

Exemple

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

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

Voir aussi

Référence

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

Autres ressources

How to: View and Modify Publication Properties (Replication Transact-SQL Programming)

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
12 décembre 2006	Nouveau contenu : Ajout d'informations sur la colonne generation_leveling_threshold.