Transact-SQL 参考

sp_addserver

定义远程服务器或本地 Microsoft® SQL Server™ 的名称。提供 sp_addserver 是为向后兼容。请使用 sp_addlinkedserver

语法

sp_addserver [ @server = ] 'server'
    [ , [ @local = ] 'local' ]
    
[ , [ @duplicate_ok = ] 'duplicate_OK' ]

参数

[@server =] 'server'

服务器的名称。虽然不允许使用空格,但是服务器的名称必须是唯一的,而且遵循 Microsoft Windows NT® 计算机名称的规则。server 是的数据类型为 sysname,无默认设置。

如果有多个 SQL Server 实例,server 可以为 servername\instancename

[@local =] 'LOCAL'

指定要添加的服务器是本地服务器还是远程服务器。@local 的数据类型为 varchar(10),默认值为 NULL。指定 @localLOCAL 将定义 @server 为本地服务器的名称并使 @@SERVERNAME 函数返回 server。(在安装过程中,安装程序将该变量设置为计算机名。建议不要更改该名称。默认情况下,用户可通过计算机名连接到 SQL Server 而无需额外的配置。)只有将服务器关闭然后重新启动后,本地的定义才会生效。每个服务器中只能定义一个本地服务器。

[@duplicate_ok =] 'duplicate_OK'

指定是否允许重复的服务器名。@duplicate_OK 的数据类型为 varchar(13),默认值为 NULL。@duplicate_OK 只能有 duplicate_OK 或 NULL 这两个值。如果指定了 duplicate_OK,则即使要添加的服务名已经存在,也不会发生错误。如果没有使用命名参数,则必须指定 @local

返回代码值

0(成功)或 1(失败)

注释

若要执行运行较早版本的 SQL Server 的远程服务器上的存储过程(远程过程调用),请使用 sp_addserver 添加远程服务器。若要执行运行 SQL Server 7.0 的远程服务器上的存储过程(或任何分布式查询),请使用 sp_addlinkedserver 添加服务器。

若要设置或清除服务器选项,请使用 sp_serveroption

在用户定义的事务内不能使用 sp_addserver

权限

只有 setupadminsysadmin 固定服务器角色的成员才能执行 sp_addserver

示例

下面的示例在本地服务器上为远程服务器 ACCOUNTS 创建一个条目。

sp_addserver 'ACCOUNTS'

请参见

sp_addlinkedserver

sp_addremotelogin

sp_dropremotelogin

sp_dropserver

sp_helpremotelogin

sp_helpserver

sp_serveroption

系统存储过程