sp_helpmergearticle (Transact-SQL)

  • Article

S’applique à :SQL Server

Retourne des informations sur un article. Cette procédure stockée est exécutée sur la base de données de publication du serveur de publication ou sur la base de données d'abonnement d'un Abonné de republication.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_helpmergearticle
    [ [ @publication = ] N'publication' ]
    [ , [ @article = ] N'article' ]
[ ; ]

Arguments

[ @publication = ] N’publication'

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

[ @article = ] N’article'

Nom de l’article pour lequel retourner des informations. @article est sysname, avec une valeur par défaut , %qui retourne des informations sur tous les articles de fusion dans la composition donnée.

Jeu de résultats

Nom de la colonne Type de données Description
id int Identificateur de l'article
name sysname Nom de l'article.
source_owner sysname Nom du propriétaire de l'objet source
source_object sysname Nom de l'objet source à partir duquel l'article doit être ajouté.
sync_object_owner sysname Nom du propriétaire de la vue qui définit l'article publié.
sync_object sysname Nom de l'objet personnalisé utilisé pour établir les données initiales pour la partition.
description nvarchar(255) Description de l'article
status tinyint État de l’article, qui peut être l’une des valeurs suivantes :

1 = inactif

2 = actif

5 = opération DDL (Data Definition Language) en attente

6= Opération DDL avec un instantané nouvellement généré

Remarque : Lorsqu’un article est réinitialisé, les valeurs et 56 sont modifiées en 2.
creation_script nvarchar(255) Chemin d'accès et nom d'un script de schéma d'article facultatif utilisé pour créer l'article dans la base de données d'abonnement.
conflict_table nvarchar(270) Nom de la table stockant les conflits d'insertion ou de mise à jour.
article_resolver nvarchar(255) Outil de résolution personnalisé pour l'article
subset_filterclause nvarchar(1000) Clause WHERE spécifiant le filtrage horizontal.
pre_creation_command tinyint Méthode de précrétion, qui peut être l’une des valeurs suivantes :

0 = aucun

1 = drop

2 = supprimer

3 = tronquer
schema_option binary(8) Bitmap de l'option de génération de schéma pour l'article. Pour plus d’informations sur cette option bitmap, consultez sp_addmergearticle ou sp_changemergearticle.
type smallint Type d’article, qui peut être l’une des valeurs suivantes :

10 = table

32 = procédure stockée

64 = vue ou vue indexée

128 = fonction définie par l’utilisateur

160 = schéma de synonyme uniquement
column_tracking int Définition du suivi au niveau des colonnes ; où 1 signifie que le suivi au niveau des colonnes est activé et 0 signifie que le suivi au niveau des colonnes est désactivé.
resolver_info nvarchar(255) Nom de l'outil de résolution de l'article
vertical_partition bit Si l’article est partitionné verticalement ; où 1 signifie que l’article est partitionné verticalement et 0 qu’il ne l’est pas.
destination_owner sysname Propriétaire de l'objet de destination. Applicable uniquement aux articles de schémas de fonctions utilisateur (UDF), aux vues et aux procédures stockées de fusion.
identity_support int Si la gestion automatique des plages d’identités est activée ; où 1 est activé et 0 est désactivé.
pub_identity_range bigint Taille de plage à utiliser lors de l'affectation de nouvelles valeurs d'identité. Pour plus d’informations, consultez la section « Réplication de fusion » de La réplication des colonnes d’identité.
identity_range bigint Taille de plage à utiliser lors de l'affectation de nouvelles valeurs d'identité. Pour plus d’informations, consultez la section « Réplication de fusion » de La réplication des colonnes d’identité.
threshold int Valeur de pourcentage utilisée pour les Abonnés exécutant SQL Server Compact ou les versions précédentes de SQL Server. thresholdcontrôle quand le Agent de fusion affecte une nouvelle plage d’identités. Lorsque le pourcentage de valeurs spécifié dans le seuil est utilisé, l'Agent de fusion crée une nouvelle plage d'identité. Pour plus d’informations, consultez la section « Réplication de fusion » de La réplication des colonnes d’identité.
verify_resolver_signature int Si une signature numérique est vérifiée avant d’utiliser un programme de résolution dans la réplication de fusion ; où 0 signifie que la signature n’est pas vérifiée et 1 signifie que la signature est vérifiée pour voir si elle provient d’une source approuvée.
destination_object sysname Nom de l'objet de destination. Applicable uniquement aux articles de schémas de fonctions utilisateur, aux vues et aux procédures stockées de fusion.
allow_interactive_resolver int Si le programme de résolution interactif est utilisé sur un article ; où 1 signifie que ce programme de résolution est utilisé, et 0 signifie qu’il n’est pas utilisé.
fast_multicol_updateproc int Active ou désactive l’Agent de fusion d’appliquer des modifications à plusieurs colonnes dans la même ligne d’une instruction UPDATE ; cela 1 signifie que plusieurs colonnes sont mises à jour dans une instruction et 0 que les instructions UPDATE distinctes sont des problèmes pour chaque colonne mise à jour.
check_permissions int Valeur entière qui représente la bitmap des autorisations au niveau des tables qui sont vérifiées. Pour obtenir la liste des valeurs possibles, consultez sp_addmergearticle (Transact-SQL).
processing_order int Ordre selon lequel les modifications de données sont appliquées aux articles d'une publication.
upload_options tinyint Définit des restrictions sur les mises à jour effectuées sur un Abonné ayant un abonnement client. Peut avoir une des valeurs suivantes.

0 = Il n’existe aucune restriction sur les mises à jour effectuées sur un Abonné avec un abonnement client ; toutes les modifications sont chargées sur le serveur de publication.

1 = Les modifications sont autorisées sur un Abonné avec un abonnement client, mais elles ne sont pas chargées sur le serveur de publication.

2 = Les modifications ne sont pas autorisées sur un Abonné avec un abonnement client.

Pour plus d’informations, consultez Optimiser les performances de la réplication de fusion avec les articles en téléchargement seul.
identityrangemanagementoption int Indique si la gestion automatique des plages d'identité est activée. 1 est activé et 0 est désactivé.
delete_tracking bit Spécifie si les suppressions sont répliquées. 1 signifie que les suppressions sont répliquées et 0 qu’elles ne le sont pas.
compensate_for_errors bit Indique si des actions de compensation sont effectuées lorsque des erreurs sont rencontrées pendant la synchronisation ; où 1 indique que les actions de compensation sont effectuées et 0 signifie que les actions de compensation ne sont pas effectuées.
partition_options tinyint Définit la façon dont les données de l’article sont partitionnée. Cette option active les optimisations des performances lorsque toutes les lignes appartiennent à une seule partition ou dans un seul abonnement. partition_options peut être l’une des valeurs suivantes.

0 = Le filtrage de l’article est statique ou ne génère pas de sous-ensemble unique de données pour chaque partition ; autrement dit, il s’agit d’une partition « qui se chevauche ».

1 = Les partitions se chevauchent et les mises à jour du langage de manipulation des données (DML) effectuées sur l’Abonné ne peuvent pas modifier la partition à laquelle appartient une ligne.

2 = Le filtrage de l’article génère des partitions qui ne se chevauchent pas, mais plusieurs Abonnés peuvent recevoir la même partition.

3 = Le filtrage de l’article génère des partitions qui ne se chevauchent pas pour chaque abonnement.
artid uniqueidentifier Identificateur qui identifie l'article de façon unique
pubid uniqueidentifier Identificateur qui identifie de manière unique la publication dans laquelle l'article est publié.
stream_blob_columns bit Indique si un optimisation du flux de données est utilisée lors de la réplication de colonnes BLOB (binary large objects). 1 signifie que l’optimisation est utilisée, et 0 signifie que l’optimisation n’est pas utilisée.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

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

Autorisations

Seuls les membres du rôle de base de données fixe db_owner dans la base de données de publication, le rôle replmonitor dans la base de données de distribution ou la liste d’accès à la publication pour une publication peuvent s’exécuter sp_helpmergearticle.

Exemples

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

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

Contenu connexe