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),必须是其中一个值。

说明
collation compatible 影响分布式查询在链接服务器上的执行。 如果此选项设置为 True,
data access 启用和禁用链接服务器以进行分布式查询访问。
dist 分发服务器。
dpub 到该分发服务器的远程发布服务器。
lazy schema validation 在查询开始跳过远程表的架构检查。
pub Publisher。
rpc 从指定的服务器启用 RPC。
rpc out 对指定的服务器启用 RPC。
sub 订户。
system 标识为仅供参考。 不支持。 不保证以后的兼容性。
use remote collation 使用远程列的排序规则,而不是本地服务器的排序规则。

[ @show_topology = ] 'show_topology'

指定服务器与其他服务器的关系。 @show_topology为 varchar(1),默认值为 NULL. 如果@show_topology不等于或等于tNULLsp_helpserver则返回结果集部分中列出的列。 如果@show_topology等于,除了结果集中列出的列外,sp_helpserver还返回topxtopy信息。t

返回代码值

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