sp_helparticle (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

Affiche des informations sur un article. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication. Dans le cas des serveurs de publication Oracle, cette procédure stockée est exécutée sur n'importe quelle base de données du serveur de distribution.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_helparticle
    [ @publication = ] N'publication'
    [ , [ @article = ] N'article' ]
    [ , [ @returnfilter = ] returnfilter ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @found = ] found OUTPUT ]
[ ; ]

Arguments

[ @publication = ] N’publication'

Nom de la publication. @publication est sysname, sans valeur par défaut.

[ @article = ] N’article'

Nom d’un article dans la composition. @article est sysname, avec la valeur par défaut %. Si @article n’est pas fourni, des informations sur tous les articles de la composition spécifiée sont retournées.

[ @returnfilter = ] returnfilter

Indique si la clause filter doit être retournée. @returnfilter est bit, avec une valeur par défaut 1, qui retourne la clause de filtre.

[ @publisher = ] N’publisher'

Spécifie un serveur de publication non-SQL Server. @publisher est sysname, avec la valeur par défaut NULL.

@publisher ne doit pas être spécifié lors de la demande d’informations sur un article publié par un serveur de publication SQL Server.

[ @found = ] found OUTPUT

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

Jeu de résultats

Nom de la colonne Type de données Description
article id int ID de l’article.
article name sysname Nom de l'article.
base object nvarchar(257) Nom de la table sous-jacente représentée par l'article ou la procédure stockée.
destination object sysname Nom de la table de destination (abonnement)
synchronization object nvarchar(257) Nom de la vue qui définit l’article publié.
type smallint Type d'article :

1 = Basé sur les journaux.
3 = Basé sur les journaux avec un filtre manuel.
5 = Basé sur les journaux avec une vue manuelle.
7 = Basé sur les journaux avec un filtre manuel et une vue manuelle.
8 = Exécution de procédure stockée.
24 = Exécution de procédure stockée sérialisable.
32 = Procédure stockée (schéma uniquement).
64 = Affichage (schéma uniquement).
96 = Fonction d’agrégation (schéma uniquement).
128 = Fonction (schéma uniquement).
257 = Vue indexée basée sur les journaux.
259 = Vue indexée basée sur les journaux avec un filtre manuel.
261 = Vue indexée basée sur les journaux avec vue manuelle.
263 = Vue indexée basée sur les journaux avec un filtre manuel et une vue manuelle.
320 = Vue indexée (schéma uniquement).
status tinyint Il peut s’agir du résultat > (AND au niveau du bit) d’une ou plusieurs propriétés d’article suivantes :

0x00 = Identifié à des fins d’information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
0x01 = L’article est actif.
0x08 = Incluez le nom de colonne dans les instructions Insert.
0x16 = Utiliser des instructions paramétrables.
0x32 = Utilisez des instructions paramétrables et incluez le nom de colonne dans les instructions insert.
filter nvarchar(257) Procédure stockée utilisée pour filtrer la table horizontalement. Cette procédure stockée doit être créée à l’aide de la FOR REPLICATION clause.
description nvarchar(255) Entrée descriptive de l'article
insert_command nvarchar(255) Type de commande de réplication utilisé pour répliquer des insertions avec des articles de table. 1
update_command nvarchar(255) Type de commande de réplication utilisé pour répliquer des mises à jour avec des articles de table. 1
delete_command nvarchar(255) Type de commande de réplication utilisé pour répliquer des suppressions avec des articles de table. 1
creation script path nvarchar(255) Chemin d'accès et nom d'un script de schéma d'article utilisé pour créer des tables cibles.
vertical partition bit Indique si le partitionnement vertical est activé pour l’article ; où une valeur de 1 signifie que le partitionnement vertical est activé.
pre_creation_cmd tinyint Commande de précréation pour DROP TABLE, DELETE TABLEou TRUNCATE TABLE.
filter_clause ntext Clause WHERE spécifiant le filtrage horizontal.
schema_option binary(8) Bitmap de l’option de génération de schéma pour l’article donné. Pour obtenir la liste complète des schema_option valeurs, consultez sp_addarticle.
dest_owner sysname Nom du propriétaire de l’objet de destination.
source_owner sysname Propriétaire de l'objet source.
unqua_source_object sysname Nom de l'objet source sans le nom du propriétaire.
sync_object_owner sysname Propriétaire de la vue qui définit l'article publié.
unqualified_sync_object sysname Nom de la vue qui définit l'article publié, sans le nom du propriétaire.
filter_owner sysname Propriétaire du filtre.
unqua_filter sysname Nom du filtre, sans le nom du propriétaire.
auto_identity_range int Indicateur signalant si la gestion automatique de plages d'identité était activée sur la publication au moment de sa création. 1 signifie que la plage d’identités automatique est activée ; 0 signifie qu’il est désactivé.
publisher_identity_range int Taille de plage de la plage d’identité sur le serveur de publication si l’article a identityrangemanagementoption défini auto ou auto_identity_range défini sur true.
identity_range bigint Taille de plage de la plage d’identité sur l’Abonné si l’article a identityrangemanagementoption défini auto ou auto_identity_range défini sur true.
threshold bigint Valeur de pourcentage indiquant le moment où l'Agent de distribution affecte une nouvelle plage d'identité.
identityrangemanagementoption int Indique la gestion des plages d'identité appliquée à l'article.
fire_triggers_on_snapshot bit Indique si les déclencheurs de l'utilisateur répliqués sont exécutés lorsque l'instantané initial est appliqué.

1 = les déclencheurs utilisateur sont exécutés.
0 = les déclencheurs utilisateur ne sont pas exécutés.

1 Pour plus d’informations, consultez les articles transactionnels - Spécifier la façon dont les modifications sont propagées.

Valeurs des codes de retour

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

Notes

sp_helparticle est utilisé dans la réplication d’instantanés et la réplication transactionnelle.

autorisations

Seuls les membres du rôle serveur fixe sysadmin , le rôle de base de données fixe db_owner ou la liste d’accès à la publication pour la publication actuelle peuvent s’exécuter sp_helparticle.

Exemples

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

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