sp_article_validation (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

Lance une demande de validation de données pour l'article spécifié. 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é.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @publication = ] N’publication'

Nom de la publication dans laquelle l’article existe. @publication est sysname, sans valeur par défaut.

[ @article = ] N’article'

Nom de l’article à valider. @article est sysname, sans valeur par défaut.

[ @rowcount_only = ] rowcount_only

Spécifie si seul le décompte de lignes est retourné pour la table. @rowcount_only est smallint, avec une valeur par défaut de 1.

  • Si 0, effectuez un nombre de lignes et une somme de contrôle compatible SQL Server 7.0.
  • Si 1, effectuez une vérification de nombre de lignes uniquement.
  • Si 2, effectuez un nombre de lignes et une somme de contrôle binaire.

[ @full_or_fast = ] full_or_fast

Méthode utilisée pour calculer le nombre de lignes. @full_or_fast est tinyint et peut être l’une des valeurs suivantes :

Valeur Description
0 Effectue le nombre complet à l’aide COUNT(*)de .
1 Effectue le nombre rapide à partir de sysindexes.rows. Le comptage de lignes est sysindexes plus rapide que le comptage de lignes dans la table réelle. Toutefois, sysindexes la mise à jour est différée et le nombre de lignes peut ne pas être exact.
2 (valeur par défaut) Exécute un comptage rapide conditionnel en essayant d'abord la méthode rapide. Si la méthode rapide affiche des différences, revient à la méthode totale. Si expected_rowcount c’est NULL le cas et si la procédure stockée est utilisée pour obtenir la valeur, une valeur complète COUNT(*) est toujours utilisée.

[ @shutdown_agent = ] shutdown_agent

Spécifie si l'Agent de distribution doit être fermé immédiatement après l'achèvement de la validation. @shutdown_agent est bit, avec la valeur par défaut 0.

  • Si 0, le Agent de distribution ne s’arrête pas.
  • Si 1, le Agent de distribution s’arrête une fois l’article validé.

[ @subscription_level = ] subscription_level

Spécifie si la validation est récupérée par un ensemble d'abonnés. @subscription_level est bit, avec la valeur par défaut 0.

  • Si 0, la validation est appliquée à tous les Abonnés.
  • Si 1, la validation est appliquée uniquement à un sous-ensemble des Abonnés spécifiés par les appels à sp_marksubscriptionvalidation la transaction ouverte actuelle.

[ @reserved = ] réservé

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

[ @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 utilisé lors de la demande de validation sur un serveur de publication SQL Server.

Valeurs des codes de retour

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

Notes

sp_article_validation est utilisé dans la réplication transactionnelle.

sp_article_validation entraîne la collecte des informations de validation sur l’article spécifié et publie une demande de validation dans le journal des transactions. 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. Les résultats de la validation sont affichés dans le moniteur de réplication et dans les alertes DE SQL Server Agent.

autorisations

Seuls les utilisateurs disposant SELECT ALL d’autorisations sur la table source pour l’article en cours de validation peuvent s’exécuter sp_article_validation.