sp_helppeerrequests (Transact-SQL)

Applies to: SQL Server

Returns information on all status requests received by participants in a peer-to-peer replication topology, where these requests were initiated by executing sp_requestpeerresponse at any published database in the topology. 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.

Transact-SQL syntax conventions

Syntax

sp_helppeerrequests
    [ @publication = ] N'publication'
    [ , [ @description = ] N'description' ]
[ ; ]

Arguments

[ @publication = ] N'publication'

The name of the publication in a peer-to-peer topology for which status requests were sent. @publication is sysname, with no default.

[ @description = ] N'description'

Specifies a value that can be used to identify individual status requests, enabling you to filter returned responses based on user defined information supplied when calling sp_requestpeerresponse. @description is nvarchar(4000), with a default of %. By default, all status requests for the publication are returned. This parameter is used to return only status requests with a description matching the value supplied in @description, where character strings are matched using a LIKE clause.

Result set

Column name Data type Description
id int Identifies a request.
publication sysname Name of the publication for which the status request was sent.
sent_date datetime Date and time that the status request was sent.
description nvarchar(4000) User defined information that can be used to identify individual status requests.

Return code values

0 (success) or 1 (failure).

Remarks

sp_helppeerrequests is used in peer-to-peer transactional replication.

sp_helppeerrequests is used when restoring a database published in a peer-to-peer topology.

Permissions

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