Share via

sp_helpserver (Transact-SQL)

  • 文章

適用於：SQL Server

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

Transact-SQL 語法慣例

語法

sp_helpserver
    [ [ @server = ] N'server' ]
    [ , [ @optname = ] 'optname' ]
    [ , [ @show_topology = ] 'show_topology' ]
[ ; ]

引數

[ @server = ] N'server'

指定報告資訊的相關伺服器。 @server為 sysname，預設值為 NULL。 未指定伺服器時，傳回 中master.sys.servers所有伺服器的相關信息。

[ @optname = ] 'optname'

描述伺服器的選項。 @optname為 varchar（35），而且必須是下列其中一個值。

值 Description
collation compatible 對連結的伺服器影響分散式查詢執行。 如果此選項設定為 true，
data access 啟用和停用連結伺服器的分散式查詢存取。
dist 轉銷商。
dpub 遠端發行者到此散發者。
lazy schema validation 略過查詢開頭遠端數據表的架構檢查。
pub 發行者。
rpc 從指定的伺服器啟用 RPC。
rpc out 啟用對指定伺服器的 RPC。
sub 使用者。
system 僅供參考之用。 不支援。 我們無法保證未來的相容性。
use remote collation 使用遠端資料行的定序，而不是本地伺服器的定序。

[ @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';

相關內容