| title | sp_helppeerrequests (Transact-SQL) | ||
|---|---|---|---|
| description | sp_helppeerrequests returns information on all status requests received by participants in a peer-to-peer replication topology. | ||
| author | markingmyname | ||
| ms.author | maghan | ||
| ms.reviewer | randolphwest | ||
| ms.date | 06/23/2025 | ||
| ms.service | sql | ||
| ms.subservice | replication | ||
| ms.topic | reference | ||
| f1_keywords |
|
||
| helpviewer_keywords |
|
||
| dev_langs |
|
[!INCLUDE 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.
:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions
sp_helppeerrequests
[ @publication = ] N'publication'
[ , [ @description = ] N'description' ]
[ ; ]
The name of the publication in a peer-to-peer topology for which status requests were sent. @publication is sysname, with no default.
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.
| 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. |
0 (success) or 1 (failure).
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.
Only members of the sysadmin fixed server role or the db_owner fixed database role can execute sp_helppeerrequests.