sp-gettopologyinfo-transact-sql.md

title	sp_gettopologyinfo (Transact-SQL) | Microsoft Docs
ms.custom
ms.date	03/06/2017
ms.prod	sql-server-2016
ms.reviewer
ms.suite
ms.technology	replication
ms.tgt_pltfrm
ms.topic	language-reference
applies_to	SQL Server
f1_keywords	sp_gettopologyinfo_TSQL sp_gettopologyinfo
helpviewer_keywords	sp_gettopologyinfo
ms.assetid	8bbe8a06-a4aa-4219-8402-12db6a4682c6
caps.latest.revision	10
author	BYHAM
ms.author	rickbyh
manager	jhubbard

sp_gettopologyinfo (Transact-SQL)

[!INCLUDEtsql-appliesto-ss2008-xxxx-xxxx-xxx_md]

Returns information about a peer-to-peer transactional replication topology. Execute sp_requestpeertopologyinfo to collect information before you execute this procedure.

Transact-SQL Syntax Conventions

Syntax

  
sp_gettopologyinfo [ @request_id = ] request_id  

Arguments

[ @request_id= ] request_id
Is the ID of a topology status request. request_id is int, with a default of NULL. To obtain an ID, use the @request_id output parameter from sp_requestpeertopologyinfo or query the MSpeer_topologyrequest system table.

Result Sets

sp_gettopologyinfo returns a result set that has a single XML column. The data in the XML column is the same as the data in the MSpeer_topologyresponse system table.

Return Code Values

0 (success) or 1 (failure)

Remarks

sp_gettopologyinfo is used in peer-to-peer transactional replication. Execute sp_requestpeertopologyinfo before you execute sp_gettopologyinfo. These procedures are used by the Configure Peer-to-Peer Topology Wizard, but they can also be used directly if you require topology information in an XML format. If you prefer tabular results, query the MSpeer_topologyresponse system table.

Permissions

Requires membership in the sysadmin fixed server role or db_owner fixed database role.

See Also

Peer-to-Peer Transactional Replication
Replication Stored Procedures (Transact-SQL)