sp_addserver (Transact-SQL)

Статья
06/18/2013

Определяет имя локального экземпляра SQL Server. Если компьютер, на котором размещается SQL Server, переименован, используйте хранимую процедуру sp_addserver, чтобы сообщить экземпляру компонента Компонент SQL Server Database Engine новое имя компьютера. Эта процедура должна быть выполнена на всех экземплярах компонента Компонент Database Engine, размещенных на компьютере. Невозможно изменить имя компонента Компонент Database Engine.

Значок ссылки на раздел Синтаксические обозначения 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 используется имя компьютера, и никакая дополнительная настройка не требуется.

Локальное переопределение вступает в силу только после перезагрузки компонента Компонент Database Engine. На каждом экземпляре компонента Компонент Database Engine может быть определен только один локальный сервер.
[ @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.

Примеры

В следующем примере запись компонента Компонент Database Engine, содержащая имя компьютера, на котором размещается SQL Server, изменяется на ACCOUNTS.