sp_posttracertoken (T-SQL)

Berlaku untuk: SQL Server

Prosedur ini memposting token pelacak ke dalam log transaksi di Publisher dan memulai proses pelacakan statistik latensi. Informasi dicatat ketika token pelacak ditulis ke log transaksi, ketika diambil oleh Agen Pembaca Log, dan ketika diterapkan oleh Agen Distribusi. Prosedur tersimpan ini dijalankan di Publisher pada database publikasi. Untuk informasi selengkapnya, lihat Mengukur Latensi dan Memvalidasi Koneksi untuk Replikasi Transaksional.

Konvensi sintaks transact-SQL

Sintaks

  
sp_posttracertoken [ @publication = ] 'publication'   
    [ , [ @tracer_token_id = ] tracer_token_id OUTPUT  
    [ , [ @publisher = ] 'publisher'   

Argumen

[ @publication = ] 'publication' Adalah nama publikasi yang latensinya sedang diukur. publikasi adalah sysname, tanpa default.

[ @tracer_token_id = ] _tracer_token_id OUTPUT Adalah ID token pelacak yang dimasukkan. tracer_token_id int dengan default NULL, dan ini adalah parameter OUTPUT. Nilai ini dapat digunakan untuk mengeksekusi sp_helptracertokenhistory (Transact-SQL) atau sp_deletetracertokenhistory (Transact-SQL) tanpa terlebih dahulu mengeksekusi sp_helptracertokens (Transact-SQL).

[ @publisher = ] 'publisher' Menentukan Penerbit SQL Server non-Microsoft. publisher adalah sysname, dengan default NULL dan tidak boleh ditentukan untuk Penerbit SQL Server.

Mengembalikan Nilai Kode

0 (berhasil) atau 1 (kegagalan)

Keterangan

sp_posttracertoken digunakan dalam replikasi transaksional.

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 atau peran database tetap db_owner yang dapat dijalankan sp_posttracertoken.

Lihat Juga

Mengukur Latensi dan Memvalidasi Koneksi untuk Replikasi Transaksional