sp_gettopologyinfo (Transact-SQL)

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

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

sp_gettopologyinfo [ @request_id = ] request_id

Argumente

  • [ @request_id = ] request_id
    Die ID einer Topologiestatusanforderung. request_id ist vom Datentyp int und hat den Standardwert NULL. Um eine ID zu erhalten, verwenden Sie den @request_id-Ausgabeparameter von sp_requestpeertopologyinfo, oder fragen Sie die Systemtabelle Mspeer_topologyrequest ab.

Resultsets

sp_gettopologyinfo gibt ein Resultset zurück, das aus einer einzelnen XML-Spalte besteht. Die Daten in der XML-Spalte sind mit den Daten in der Systemtabelle MSpeer_topologyresponse identisch.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_gettopologyinfo wird in der Peer-to-Peer-Transaktionsreplikation verwendet. Führen Sie sp_requestpeertopologyinfo aus, bevor Sie sp_gettopologyinfo ausführen. Diese Prozeduren werden vom Assistenten zum Konfigurieren der Peer-to-Peer-Topologie verwendet, können jedoch auch direkt verwendet werden, wenn Sie Topologiedaten in einem XML-Format benötigen. Wenn Sie Tabellenergebnisse vorziehen, fragen Sie die Systemtabelle MSpeer_topologyresponse ab.

Berechtigungen

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