sp_helparticle (Transact-SQL)

Article
01/10/2024

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 = ] 'publication'   
    [ , [ @article = ] 'article' ]  
    [ , [ @returnfilter = ] returnfilter ]  
    [ , [ @publisher = ] 'publisher' ]  
    [ , [ @found = ] found OUTPUT ]

Arguments

[ @publication = ] 'publication' Nom de la composition. la publication est sysname, sans valeur par défaut.

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

[ @returnfilter = ] returnfilter Spécifie si la clause de filtre doit être retournée. returnfilter est bit, avec une valeur par défaut de 1, qui retourne la clause de filtre.

[ @publisher = ] 'publisher' Spécifie un éditeur non-Microsoft SQL Server. publisher est sysname, avec une valeur par défaut null.

Remarque

l’éditeur 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 Utilisation interne uniquement.

Jeux de résultats

Nom de la colonne	Type de données	Description
ID d’article	int	ID de l’article.
nom de l’article	sysname	Nom de l'article.
objet de base	nvarchar(257)	Nom de la table sous-jacente représentée par l'article ou la procédure stockée.
objet de destination	sysname	Nom de la table de destination (abonnement)
objet de synchronisation	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).
statut	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 = Inclure le nom de colonne dans les instructions Insert. 0x16 = Utiliser des instructions paramétrables. 0x32 = Utiliser des instructions paramétrables et inclure 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 avoir été créée à l'aide de la clause FOR REPLICATION.
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. Pour plus d’informations, consultez Spécifier le mode de propagation des modifications des articles transactionnels.
update_command	nvarchar(255)	Type de commande de réplication utilisé pour répliquer des mises à jour avec des articles de table. Pour plus d’informations, consultez Spécifier le mode de propagation des modifications des articles transactionnels.
delete_command	nvarchar(255)	Type de commande de réplication utilisé pour répliquer des suppressions avec des articles de table. Pour plus d’informations, consultez Spécifier le mode de propagation des modifications des articles transactionnels.
chemin d’accès du script de création	nvarchar(255)	Chemin d'accès et nom d'un script de schéma d'article utilisé pour créer des tables cibles.
partition verticale	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 les instructions DROP TABLE, DELETE TABLE, ou 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 valeurs schema_option, consultez sp_addarticle (Transact-SQL).
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é 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 défini identityrangemanagementoption sur 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 défini identityrangemanagementoption sur 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_instantané	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.

Codet de retour

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

Notes

sp_helparticle est utilisé dans la réplication instantané 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 actuelle peuvent exécuter sp_helparticle.

Exemple

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

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

Voir aussi

Afficher et modifier les propriétés d’un article
sp_addarticle (Transact-SQL)
sp_articlecolumn (Transact-SQL)
sp_changearticle (Transact-SQL)
sp_droparticle (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)