sp_helpserver (Transact-SQL)

發行項
08/21/2023

適用於：SQL Server

報告特定遠端或複寫伺服器的相關資訊，或報告這兩種類型之所有伺服器的相關資訊。提供伺服器名稱、伺服器的網路名稱、伺服器的複寫狀態、伺服器的識別碼，以及定序名稱。也提供連線至連結伺服器或查詢的逾時值。

語法

  
sp_helpserver [ [ @server = ] 'server' ]   
  [ , [ @optname = ] 'option' ]   
  [ , [ @show_topology = ] 'show_topology' ]

引數

[ @server = ] 'server' 這是報告資訊的伺服器。未指定伺服器時，會報告 master.sys.servers 中的所有 伺服器。 伺服器 是 sysname ，預設值為 Null。

[ @optname = ] 'option' 這是描述伺服器的選項。 option 是 Varchar（ 35 ） ，預設值為 Null，而且必須是下列其中一個值。

值	Description
定序相容	對連結的伺服器影響分散式查詢執行。如果此選項設定為 true，
資料存取	啟用和停用連結伺服器的分散式查詢存取。
dist	轉銷商。
dpub	遠端發行者到此散發者。
延遲架構驗證	略過查詢開頭遠端資料表的架構檢查。
酒吧	發行者。
Rpc	從指定的伺服器啟用 RPC。
rpc out	啟用對指定伺服器的 RPC。
子	使用者。
系統	僅供參考之用。不支援。我們無法保證未來的相容性。
使用遠端定序	使用遠端資料行的定序，而不是本機伺服器的定序。

[ @show_topology = ] 'show_topology' 這是指定伺服器與其他伺服器的關聯性。 show_topology 為 Varchar（ 1 ） ，預設值為 Null。如果 show_topology 不等於 t 或為 Null， sp_helpserver 會傳回結果集區段中所列的資料行。如果 show_topology 等於 t ，除了結果集中所列的資料行之外， sp_helpserver 也會傳 回 topx 和 topy 資訊。

傳回碼值

0 （成功）或 1 （失敗）。

結果集

資料行名稱	資料類型	描述
name	sysname	伺服器名稱。
network_name	sysname	伺服器的網路名稱。
status	Varchar（ 70 ）	伺服器狀態。
id	char（ 4 ）	伺服器的識別碼。
collation_name	sysname	伺服器的定序。
connect_timeout	int	連線到連結伺服器的逾時值。
query_timeout	int	針對連結伺服器的查詢逾時值。

備註

伺服器可以有多個狀態。

權限

不會檢查任何許可權。

範例

A. 顯示所有伺服器的相關資訊

下列範例會顯示所有伺服器的相關資訊，但未搭配任何 sp_helpserver 參數使用。

USE master;  
GO  
EXEC sp_helpserver;

B. 顯示特定伺服器的相關資訊

下列範例會顯示伺服器的所有資訊 SEATTLE2 。

USE master;  
GO  
EXEC sp_helpserver 'SEATTLE2';

另請參閱

Database Engine 預存程式（Transact-SQL）
sp_adddistpublisher (Transact-SQL)
sp_addserver (Transact-SQL)
sp_addsubscriber (Transact-SQL)
sp_changesubscriber (Transact-SQL)
sp_dropserver (Transact-SQL)
sp_dropsubscriber （Transact-SQL）
sp_helpdistributor (Transact-SQL)
sp_helpremotelogin （Transact-SQL）
sp_helpsubscriberinfo (Transact-SQL)
sp_serveroption (Transact-SQL)
系統預存程序 (Transact-SQL)