sp_addserver (Transact-SQL)

定义 SQL Server 本地实例的名称。 重命名承载 SQL Server 的计算机后,请使用 sp_addserver 向 SQL Server 数据库引擎实例通知新的计算机名称。 必须在该计算机承载的所有数据库引擎实例上执行此过程。 无法更改数据库引擎的实例名称。

主题链接图标 Transact-SQL 语法约定

语法

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

参数

  • [ @server = ] 'server'
    服务器的名称。 服务器名称必须唯一且必须符合 Microsoft Windows 计算机名称的规则,但不允许包含空格。 server 的数据类型为 sysname,无默认值。

    如果计算机上安装了多个 SQL Server 实例,则实例将如同在一个独立服务器上运行。 通过以下格式引用 server 来指定命名实例:servername\instancename。

  • [ @local = ] 'LOCAL'
    将正添加的服务器指定为本地服务器。 @local 的数据类型为 varchar(10),默认值为 NULL。 将 @local 指定为 LOCAL 会将 @server 定义为本地服务器的名称,并使 @@SERVERNAME 函数返回 server 的值。

    SQL Server 安装程序会在安装过程中将此变量设置为计算机名称。 默认情况下,用户可通过计算机名连接到 SQL Server 的实例而无需额外的配置。

    只有重新启动数据库引擎后,本地的定义才会生效。 每个数据库引擎实例中只能定义一个本地服务器。

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

返回代码值

0(成功)或 1(失败)

注释

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

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

不再使用 sp_addserver 来添加远程服务器。 改为使用 sp_addlinkedserver

权限

要求具有 setupadmin 固定服务器角色的成员身份。

示例

下面的示例将承载 SQL Server 的计算机名称的数据库引擎条目更改为 ACCOUNTS。

sp_addserver 'ACCOUNTS', 'local';

请参阅

任务

重命名承载 SQL Server 独立实例的计算机

参考

sp_addlinkedserver (Transact-SQL)

sp_dropserver (Transact-SQL)

sp_helpserver (Transact-SQL)

系统存储过程 (Transact-SQL)

安全存储过程 (Transact-SQL)