sp_deletepeerrequesthistory (Transact-SQL)

Deletes history related to a publication status request, which includes the request history (MSpeer_request (Transact-SQL)) as well as the response history (MSpeer_response (Transact-SQL)).This stored procedure is executed on the publication database at a Publisher participating in a Peer-to-Peer replication topology. For more information, see Peer-to-Peer Transactional Replication.

Topic link iconTransact-SQL Syntax Conventions

Syntax

sp_deletepeerrequesthistory [ @publication= ] 'publication'
    [ , [ @request_id= ] request_id ]
    [ , [ @cutoff_date= ] cutoff_date ]

Arguments

  • [ @publication= ] 'publication'
    Name of the publication for which the status request was made. publication is sysname, with no default.

  • [ @request_id= ] request_id
    Specifies an individual status request so that all responses to this request will be deleted. request_id is int, with a default value of NULL.

  • [ @cutoff_date= ] cutoff_date
    Specifies a cutoff date, before which all earlier response records are deleted. cutoff_date is datetime, with a default value of NULL.

Return Code Values

0 (success) or 1 (failure)

Remarks

sp_deletepeerrequesthistory is used in a Peer-to-Peer transactional replication topology. For more information, see Peer-to-Peer Transactional Replication.

When executing sp_deletepeerrequesthistory, either request_id or cutoff_date must be specified.

Permissions

Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_deletepeerrequesthistory.