Bagikan melalui

sp_helptracertokens (T-SQL)

  • Artikel

Berlaku untuk: SQL Server Azure SQL Managed Instance

Mengembalikan satu baris untuk setiap token pelacak yang disisipkan ke dalam publikasi untuk menentukan latensi. Prosedur tersimpan ini dijalankan di Publisher pada database publikasi atau di Distributor pada database distribusi.

Konvensi sintaks transact-SQL

Sintaks

sp_helptracertokens
    [ @publication = ] N'publication'
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
[ ; ]

Argumen

[ @publication = ] N'publikasi'

Nama publikasi tempat token pelacak dimasukkan. @publication adalah sysname, tanpa default.

[ @publisher = ] N'publisher'

Nama Publisher. @publisher adalah sysname, dengan default NULL.

@publisher hanya boleh ditentukan untuk Penerbit non-SQL Server.

[ @publisher_db = ] N'publisher_db'

Nama database publikasi. @publisher_db adalah sysname, dengan default NULL. @publisher_db diabaikan jika prosedur tersimpan dijalankan di Publisher.

Tataan hasil

Nama kolom Jenis data Deskripsi
tracer_id int Mengidentifikasi rekaman token pelacak.
publisher_commit datetime Tanggal dan waktu catatan token diterapkan di Publisher dalam database publikasi.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_helptracertokens digunakan dalam replikasi transaksional.

sp_helptracertokens digunakan untuk mendapatkan ID token pelacak saat menjalankan sp_helptracertokenhistory.

Contoh

DECLARE @publication AS sysname;
DECLARE @tokenID AS int;
SET @publication = N'AdvWorksProductTran'; 

USE [AdventureWorks2022]

-- Insert a new tracer token in the publication database.
EXEC sys.sp_posttracertoken 
  @publication = @publication,
  @tracer_token_id = @tokenID OUTPUT;
SELECT 'The ID of the new tracer token is ''' + 
    CONVERT(varchar,@tokenID) + '''.'
GO

-- Wait 10 seconds for the token to make it to the Subscriber.
WAITFOR DELAY '00:00:10';
GO

-- Get latency information for the last inserted token.
DECLARE @publication AS sysname;
DECLARE @tokenID AS int;
SET @publication = N'AdvWorksProductTran'; 

CREATE TABLE #tokens (tracer_id int, publisher_commit datetime)

-- Return tracer token information to a temp table.
INSERT #tokens (tracer_id, publisher_commit)
EXEC sys.sp_helptracertokens @publication = @publication;
SET @tokenID = (SELECT TOP 1 tracer_id FROM #tokens
ORDER BY publisher_commit DESC)
DROP TABLE #tokens

-- Get history for the tracer token.
EXEC sys.sp_helptracertokenhistory 
  @publication = @publication, 
  @tracer_id = @tokenID;
GO

Izin

Hanya anggota peran server tetap sysadmin , peran database tetap db_owner dalam database publikasi, atau db_owner peran database tetap atau replmonitor dalam database distribusi yang dapat dijalankan sp_helptracertokenhistory.

Konten terkait