sp_getqueuedrows (Transact-SQL)

S’applique à : SQL Server

Extrait, de l'Abonné, les lignes pour lesquelles il existe des mises à jour dans la file d'attente. Cette procédure stockée est exécutée sur la base de données d'abonnement de l'Abonné.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_getqueuedrows
    [ @tablename = ] N'tablename'
    [ , [ @owner = ] N'owner' ]
    [ , [ @tranid = ] N'tranid' ]
[ ; ]

Arguments

[ @tablename = ] N’tablename'

Nom de la table. @tablename est sysname, sans valeur par défaut. La table doit faire partie d'un abonnement en file d'attente.

[ @owner = ] N’owner'

Propriétaire de l’abonnement. @owner est sysname, avec la valeur par défaut NULL.

[ @tranid = ] N’tranid'

Permet de filtrer les données de sortie par ID de transaction. @tranid est nvarchar(70), avec la valeur par défaut NULL. Si cet argument est défini, l'identificateur de transaction associé à la commande placée en file d'attente est affiché. Si NULL, toutes les commandes de la file d’attente sont affichées.

Valeurs des codes de retour

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

Jeu de résultats

Affiche toutes les lignes détenant actuellement au moins une transaction en attente pour la table d'abonnement.

Nom de la colonne Type de données Description
action nvarchar(10) Type d'action à appliquer au moment de la synchronisation.

INS = insertion
DEL = supprimer
UPD = mise à jour
tranid nvarchar(70) Identificateur de transaction sous lequel la commande a été exécutée.
table column1 ...n Valeur de chaque colonne de la table spécifiée dans @tablename.
msrepl_tran_version uniqueidentifier Cette colonne permet de suivre les modifications apportées aux données répliquées et d’effectuer la détection des conflits sur le serveur de publication. Cette colonne est automatiquement ajoutée à la table.

Notes

sp_getqueuedrows est utilisé sur les Abonnés participant à la mise à jour en file d’attente.

sp_getqueuedrows recherche les lignes d’une table donnée sur une base de données d’abonnement qui ont participé à une mise à jour en file d’attente, mais qui ne sont pas résolues par l’agent de lecture de file d’attente.

autorisations

sp_getqueuedrows nécessite SELECT des autorisations sur la table spécifiée dans @tablename.