sp_getqueuedrows (Transact-SQL)

Artikel
05/23/2023

Ruft beim Abonnenten Zeilen ab, die über ausstehende Updates in der Warteschlange verfügen. Diese gespeicherte Prozedur wird auf dem Abonnenten der Abonnementdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

  
sp_getqueuedrows [ @tablename = ] 'tablename'  
    [ , [ @owner = ] 'owner'  
    [ , [ @tranid = ] 'transaction_id' ]

Argumente

[ @tablename = ] 'tablename' Der Name der Tabelle. tablename ist sysname, ohne Standard. Die Tabelle muss Teil eines Abonnements in einer Warteschlange sein.

[ @owner = ] 'owner' Der Abonnementbesitzer. owner ist sysname mit dem Standardwert NULL.

[ @tranid = ] 'transaction_id' Ermöglicht das Filtern der Ausgabe nach der Transaktions-ID. transaction_id ist nvarchar(70) mit dem Standardwert NULL. Falls angegeben, wird die Transaktions-ID angezeigt, die dem Befehl in der Warteschlange zugeordnet ist. Bei einem Wert von NULL werden alle Befehle in der Warteschlange angezeigt.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Zeigt alle Zeilen an, die zurzeit über mindestens eine Transaktion in der Warteschlange für die abonnierte Tabelle verfügen.

Spaltenname	Datentyp	Beschreibung
Aktion	nvarchar(10)	Aktionstyp, der bei der Synchronisierung durchgeführt werden soll. INS= Einfügen DEL = Löschen UPD = Aktualisieren
Tranid	nvarchar(70)	Die Transaktions-ID, unter der der Befehl ausgeführt wurde.
table column1...n		Der Wert für jede Spalte der tabelle, die in tablename angegeben ist.
msrepl_tran_version	uniqueidentifier	Diese Spalte wird zum Nachverfolgen von Änderungen an replizierten Daten und für die Konflikterkennung auf dem Verleger verwendet. Diese Spalte wird automatisch der Tabelle hinzugefügt.

Bemerkungen

sp_getqueuedrows wird für Abonnenten verwendet, die an updates in der Warteschlange teilnehmen.

sp_getqueuedrows findet Zeilen einer bestimmten Tabelle in einer Abonnementdatenbank, die an einem Update in der Warteschlange teilgenommen haben, aber derzeit nicht vom Warteschlangenlese-Agent aufgelöst wurden.

Berechtigungen

sp_getqueuedrows erfordert SELECT-Berechtigungen für die in tablename angegebene Tabelle.

Weitere Informationen

Updatable Subscriptions for Transactional Replication
Konflikterkennung und -lösung beim verzögerten Update über eine Warteschlange
Gespeicherte Systemprozeduren (Transact-SQL)