sp_getqueuedrows (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server

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

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @tablename = ] N'Tabellenname'

Der Name der Tabelle. @tablename ist "sysname" ohne Standard. Die Tabelle muss Teil eines Abonnements in einer Warteschlange sein.

[ @owner = ] N'owner'

Der Abonnementbesitzer. @owner ist "sysname" mit einem Standardwert von NULL.

[ @tranid = ] N'tranid'

Ermöglicht das Filtern der Ausgabe nach der Transaktions-ID. @tranid ist nvarchar(70), wobei die Standardeinstellung istNULL. Falls angegeben, wird die Transaktions-ID angezeigt, die dem Befehl in der Warteschlange zugeordnet ist. Wenn NULL, werden alle Befehle in der Warteschlange angezeigt.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

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

Spaltenname	Datentyp	Beschreibung
`action`	nvarchar(10)	Aktionstyp, der bei der Synchronisierung durchgeführt werden soll. `INS` = einfügen `DEL` = löschen `UPD` = Update
`tranid`	nvarchar(70)	Die Transaktions-ID, unter der der Befehl ausgeführt wurde.
`table column1 ...n`		Der Wert für jede Spalte der in @tablename angegebenen Tabelle.
`msrepl_tran_version`	uniqueidentifier	Diese Spalte wird verwendet, um Änderungen an replizierten Daten nachzuverfolgen und die Konflikterkennung bei Publisher durchzuführen. Diese Spalte wird automatisch der Tabelle hinzugefügt.

Hinweise

sp_getqueuedrows wird bei Abonnenten verwendet, die an der Aktualisierung in der Warteschlange teilnehmen.

sp_getqueuedrows findet Zeilen einer bestimmten Tabelle in einer Abonnementdatenbank, die an einer Aktualisierung in der Warteschlange teilgenommen hat, aber derzeit nicht vom Agent des Warteschlangenlesers aufgelöst werden.

Berechtigungen

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

Freigeben über