sp_helpserver (Transact-SQL)

报告某个特定远程服务器或复制服务器的信息,或者报告两种类型的所有服务器的信息。提供服务器名称、服务器的网络名称、服务器的复制状态、服务器的标识号以及排序规则名称。还提供连接到链接服务器的超时值,或对链接服务器进行查询的超时值。

主题链接图标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 还返回 topxtopy 信息。

返回代码值

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'