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.
.gif "Icône Lien de rubrique")
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.
.gif "ms189475.note(fr-fr,SQL.90).gif")
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 |
|