sp_article_validation (Transact-SQL)sp_article_validation (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure Synapse Analytics (SQL DW) nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Lance une demande de validation de données pour l'article spécifié.Initiates a data validation request for the specified article. Cette procédure stockée est exécutée sur la base de données de publication du serveur de publication et sur la base de données d'abonnement de l'Abonné.This stored procedure is executed at the Publisher on the publication database and at the Subscriber on the subscription database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
sp_article_validation [ @publication = ] 'publication'  
    [ , [ @article = ] 'article' ]  
    [ , [ @rowcount_only = ] type_of_check_requested ]  
    [ , [ @full_or_fast = ] full_or_fast ]  
    [ , [ @shutdown_agent = ] shutdown_agent ]  
    [ , [ @subscription_level = ] subscription_level ]  
    [ , [ @reserved = ] reserved ]  
    [ , [ @publisher = ] 'publisher' ]  

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication dans laquelle l’article existe.[ @publication = ] 'publication' Is the name of the publication in which the article exists. publication est de type sysname, sans valeur par défaut.publication is sysname, with no default.

[ @article = ] 'article'Nom de l’article à valider.[ @article = ] 'article' Is the name of the article to validate. article est de type sysnameet n’a pas de valeur par défaut.article is sysname, with no default.

[ @rowcount_only = ] type_of_check_requestedSpécifie si seul le RowCount de la table est retourné.[ @rowcount_only = ] type_of_check_requested Specifies if only the rowcount for the table is returned. type_of_check_requested est de type smallint, avec 1comme valeur par défaut.type_of_check_requested is smallint, with a default of 1.

Si la valeur est 0, effectuez un MicrosoftMicrosoft comptage de lignes et une somme de SQL ServerSQL Server contrôle compatible 7,0.If 0, perform a rowcount and a MicrosoftMicrosoft SQL ServerSQL Server 7.0 compatible checksum.

Si 1, effectuez une vérification du ROWCOUNT uniquement.If 1, perform a rowcount check only.

Si la condition est 2, effectuez un comptage de lignes et une somme de contrôle binaire.If 2, perform a rowcount and binary checksum.

[ @full_or_fast = ] full_or_fastMéthode utilisée pour calculer le RowCount.[ @full_or_fast = ] full_or_fast Is the method used to calculate the rowcount. full_or_fast est de type tinyintet peut prendre l’une des valeurs suivantes.full_or_fast is tinyint, and can be one of these values.

ValeurValue DescriptionDescription
00 Effectue un comptage total à l’aide de COUNT (*).Performs full count using COUNT(*).
11 Effectue un comptage rapide à partir de sysindexes. Rows.Performs fast count from sysindexes.rows. Le comptage des lignes dans sysindexes est plus rapide que le comptage des lignes dans la table réelle.Counting rows in sysindexes is faster than counting rows in the actual table. Toutefois, sysindexes est mis à jour tardivement et le ROWCOUNT peut ne pas être précis.However, sysindexes is updated lazily, and the rowcount may not be accurate.
2 (par défaut)2 (default) Exécute un comptage rapide conditionnel en essayant d'abord la méthode rapide.Performs conditional fast counting by first trying the fast method. Si la méthode rapide affiche des différences, revient à la méthode totale.If fast method shows differences, reverts to full method. Si expected_rowcount a la valeur NULL et la procédure stockée est en cours d’utilisation pour obtenir la valeur, un Count (*) complète est toujours utilisée.If expected_rowcount is NULL and the stored procedure is being used to get the value, a full COUNT(*) is always used.

[ @shutdown_agent = ] shutdown_agentSpécifie si l’agent de distribution doit se fermer immédiatement à la fin de la validation.[ @shutdown_agent = ] shutdown_agent Specifies if the Distribution agent should shut down immediately upon completion of the validation. shutdown_agent est de valeur de bit, avec 0comme valeur par défaut.shutdown_agent is bit, with a default of 0. Si la valeur est 0, le agent de distribution ne s’arrête pas.If 0, the Distribution Agent does not shut down. Si la taille est 1, le agent de distribution s’arrête après la validation de l’article.If 1, the Distribution Agent shuts down after the article is validated.

[ @subscription_level = ] subscription_levelSpécifie si la validation est récupérée par un ensemble d’abonnés.[ @subscription_level = ] subscription_level Specifies whether or not the validation is picked up by a set of subscribers. subscription_level est de valeur de bit, avec 0comme valeur par défaut.subscription_level is bit, with a default of 0. Si la valeur est 0, la validation est appliquée à tous les abonnés.If 0, validation is applied to all Subscribers. Si la valeur est 1, la validation est appliquée uniquement à un sous-ensemble des abonnés spécifiés par les appels à sp_marksubscriptionvalidation dans la transaction ouverte actuelle.If 1, validation is only applied to a subset of the Subscribers specified by calls to sp_marksubscriptionvalidation in the current open transaction.

[ @reserved = ] reserved Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.[ @reserved = ] reserved Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.

[ @publisher = ] 'publisher'Spécifie un serveur MicrosoftMicrosoft de publication non- SQL ServerSQL Server .[ @publisher = ] 'publisher' Specifies a non- MicrosoftMicrosoft SQL ServerSQL Server Publisher. Publisher est de type sysname, avec NULL comme valeur par défaut.publisher is sysname, with a default of NULL.

Notes

l' éditeur ne doit pas être utilisé lors de la SQL ServerSQL Server demande de validation sur un serveur de publication.publisher should not be used when requesting validation on a SQL ServerSQL Server Publisher.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_article_validation est utilisé dans la réplication transactionnelle.sp_article_validation is used in transactional replication.

sp_article_validation provoque la collecte des informations de validation sur l’article spécifié et publie une demande de validation dans le journal des transactions.sp_article_validation causes validation information to be gathered on the specified article and posts a validation request to the transaction log. Lorsque l'Agent de distribution reçoit la requête, il compare les informations de validation de la requête à la table des Abonnés.When the Distribution Agent receives this request, the Distribution Agent compares the validation information in the request to the Subscriber table. Les résultats de la validation sont affichés dans les messages d'alerte du gestionnaire de réplication et de l'Agent SQL ServerSQL Server.The results of the validation are displayed in the Replication Monitor and in SQL ServerSQL Server Agent alerts.

AutorisationsPermissions

Seuls les utilisateurs disposant d’autorisations SELECT ALL sur la table source pour l’article en cours de validation peuvent exécuter sp_article_validation.Only users with SELECT ALL permissions on the source table for the article being validated can execute sp_article_validation.

Voir aussiSee Also

Valider les données répliquées Validate Replicated Data
sp_marksubscriptionvalidation (Transact-SQL) sp_marksubscriptionvalidation (Transact-SQL)
sp_publication_validation (Transact-SQL) sp_publication_validation (Transact-SQL)
sp_table_validation (Transact-SQL) sp_table_validation (Transact-SQL)
Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)