sp_helpserver (Transact-SQL)
报告某个特定远程服务器或复制服务器的信息,或者报告两种类型的所有服务器的信息。 提供服务器名称、服务器的网络名称、服务器的复制状态、服务器的标识号以及排序规则名称。 还提供连接到链接服务器的超时值,或对链接服务器进行查询的超时值。
语法
sp_helpserver [ [ @server = ] 'server' ]
[ , [ @optname = ] 'option' ]
[ , [ @show_topology = ] 'show_topology' ]
参数
[ @server = ] 'server'
对其信息进行报告的服务器。 如果未指定 server,则报告有关 master.sys.servers 中所有服务器的信息。 server 的数据类型为 sysname,默认值为 NULL。[ @optname = ] 'option'
对服务器进行说明的选项。 option 的数据类型为 varchar(35),默认值为 NULL,必须是下列值之一。值
说明
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'
请参阅
参考
sp_adddistpublisher (Transact-SQL)
sp_addsubscriber (Transact-SQL)
sp_changesubscriber (Transact-SQL)
sp_dropsubscriber (Transact-SQL)
sp_helpdistributor (Transact-SQL)
sp_helpremotelogin (Transact-SQL)
sp_helpsubscriberinfo (Transact-SQL)