sys.sp_gettopologyinfo (Transact-SQL)

Gilt für:SQL Server

Gibt Informationen über eine Peer-zu-Peer-Transaktionsreplikationstopologie zurück. Führen Sie sp_requestpeertopologyinfo aus, um Informationen zu sammeln, bevor Sie diese Prozedur ausführen.

Transact-SQL-Syntaxkonventionen

Syntax

sys.sp_gettopologyinfo [ [ @request_id = ] request_id ]
[ ; ]

Argumente

[ @request_id = ] request_id

Die ID einer Topologiestatusanforderung. @request_id ist int mit einem Standardwert von NULL. Um eine ID zu erhalten, verwenden Sie den @request_id-ParameterOUTPUT aus sp_requestpeertopologyinfo oder fragen Sie die MSpeer_topologyrequest Systemtabelle ab.

Resultset

sp_gettopologyinfo gibt einen Resultset zurück, der eine einzelne XML-Spalte ist. Die Daten in der XML-Spalte entsprechen den Daten in der MSpeer_topologyresponse Systemtabelle.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_gettopologyinfo wird in der Peer-to-Peer-Transaktionsreplikation verwendet. Führen Sie sp_requestpeertopologyinfo vor dem Ausführen aus sp_gettopologyinfo. Diese Verfahren werden vom Assistenten zum Konfigurieren von Peer-to-Peer-Topologien verwendet, können aber auch direkt verwendet werden, wenn Sie Topologieinformationen im XML-Format benötigen. Wenn Sie tabellarische Ergebnisse bevorzugen, fragen Sie die MSpeer_topologyresponse Systemtabelle ab.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle "sysadmin " oder db_owner festen Datenbankrolle.