Bagikan melalui

sp_helptracertokenhistory (T-SQL)

  • Artikel

Berlaku untuk: SQL Server Azure SQL Managed Instance

Mengembalikan informasi latensi terperinci untuk token pelacak tertentu, dengan satu baris dikembalikan untuk setiap Pelanggan. Prosedur tersimpan ini dijalankan di Publisher pada database publikasi atau di Distributor pada database distribusi.

Konvensi sintaks transact-SQL

Sintaks

sp_helptracertokenhistory
    [ @publication = ] N'publication'
    , [ @tracer_id = ] tracer_id
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
[ ; ]

Argumen

[ @publication = ] N'publikasi'

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

[ @tracer_id = ] tracer_id

ID token pelacak dalam tabel MStracer_tokens , yang informasi riwayatnya dikembalikan. @tracer_id int, 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. Parameter ini diabaikan jika prosedur tersimpan dijalankan di Publisher.

Tataan hasil

Nama kolom Jenis data Deskripsi
distributor_latency bigint Jumlah detik antara catatan token pelacak yang dilakukan di Penerbit dan catatan yang dilakukan di Distributor.
subscriber nama sysname Nama Pelanggan yang menerima token pelacak.
subscriber_db nama sysname Nama database langganan tempat rekaman token pelacak disisipkan.
subscriber_latency bigint Jumlah detik antara catatan token pelacak yang dilakukan di Distributor dan catatan yang dilakukan di Pelanggan.
overall_latency bigint Jumlah detik antara catatan token pelacak yang dilakukan di Penerbit dan catatan token yang dilakukan di Pelanggan.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_helptracertokenhistory digunakan dalam replikasi transaksional.

Jalankan sp_helptracertokens untuk mendapatkan daftar token pelacak untuk publikasi.

Nilai NULL dalam kumpulan hasil berarti statistik latensi tidak dapat dihitung. Ini karena token pelacak belum diterima di Distributor atau salah satu Pelanggan.

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