sp_repldone (Transact-SQL)
Collapse the table of content
Expand the table of content

sp_repldone (Transact-SQL)

Applies To: SQL Server 2014, SQL Server 2016 Preview

Topic Status: Some information in this topic is preview and subject to change in future releases. Preview information describes new features or changes to existing features in Microsoft SQL Server 2016 Community Technology Preview 2 (CTP2).

Updates the record that identifies the last distributed transaction of the server. This stored procedure is executed at the Publisher on the publication database.

Caution note Caution

If you execute sp_repldone manually, you can invalidate the order and consistency of delivered transactions. sp_repldone should only be used for troubleshooting replication as directed by an experienced replication support professional.

Topic link icon Transact-SQL Syntax Conventions

sp_repldone [ @xactid= ] xactid  
        , [ @xact_seqno= ] xact_seqno 
    [ , [ @numtrans= ] numtrans ] 
    [ , [ @time= ] time 
    [ , [ @reset= ] reset ]

[ @xactid=] xactid

Is the log sequence number (LSN) of the first record for the last distributed transaction of the server. xactid is binary(10), with no default.

[ @xact_seqno=] xact_seqno

Is the LSN of the last record for the last distributed transaction of the server. xact_seqno is binary(10), with no default.

[ @numtrans=] numtrans

Is the number of transactions distributed. numtrans is int, with no default.

[ @time=] time

Is the number of milliseconds, if provided, needed to distribute the last batch of transactions. time is int, with no default.

[ @reset=] reset

Is the reset status. reset is int, with no default. If 1, all replicated transactions in the log are marked as distributed. If 0, the transaction log is reset to the first replicated transaction and no replicated transactions are marked as distributed. reset is valid only when both xactid and xact_seqno are NULL.

0 (success) or 1 (failure)

sp_repldone is used in transactional replication.

sp_repldone is used by the log reader process to track which transactions have been distributed.

With sp_repldone, you can manually tell the server that a transaction has been replicated (sent to the Distributor). It also allows you to change the transaction marked as the next one awaiting replication. You can move forward or backward in the list of replicated transactions. (All transactions less than or equal to that transaction are marked as distributed.)

The required parameters xactid and xact_seqno can be obtained by using sp_repltrans or sp_replcmds.

Members of the sysadmin fixed server role or the db_owner fixed database role can execute sp_repldone.

When xactid is NULL, xact_seqno is NULL, and reset is 1, all replicated transactions in the log are marked as distributed. This is useful when there are replicated transactions in the transaction log that are no longer valid and you want to truncate the log, for example:

EXEC sp_repldone @xactid = NULL, @xact_segno = NULL, @numtrans = 0,     @time = 0, @reset = 1
Caution noteCaution

This procedure can be used in emergency situations to allow truncation of the transaction log when transactions pending replication are present.

Community Additions

© 2016 Microsoft