sp_addserver (Transact-SQL)sp_addserver (Transact-SQL)

ОБЛАСТЬ ПРИМЕНЕНИЯ: даSQL Server (начиная с версии 2008) нетБаза данных SQL Azure нетХранилище данных SQL AzureнетParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2008) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Определяет имя локального экземпляра SQL ServerSQL Server.Defines the name of the local instance of SQL ServerSQL Server. Когда для компьютера, на котором размещается SQL ServerSQL Server будет переименован, используйте sp_addserver чтобы сообщить экземпляру компонента Компонент SQL Server Database EngineSQL Server Database Engine нового имени компьютера.When the computer hosting SQL ServerSQL Server is renamed, use sp_addserver to inform the instance of the Компонент SQL Server Database EngineSQL Server Database Engine of the new computer name. Эта процедура должна быть выполнена на всех экземплярах компонента Компонент Database EngineDatabase Engine , размещенных на компьютере.This procedure must be executed on all instances of the Компонент Database EngineDatabase Engine hosted on the computer. Невозможно изменить имя компонента Компонент Database EngineDatabase Engine .The instance name of the Компонент Database EngineDatabase Engine cannot be changed. Чтобы изменить имя экземпляра, установите новый экземпляр с нужным именем, отключите файлы базы данных от старого экземпляра, подключите базы данных к новому экземпляру и удалите старый экземпляр.To change the instance name of a named instance, install a new instance with the desired name, detach the database files from old instance, attach the databases to the new instance and drop the old instance. Кроме того, вы можете создать имя псевдонима клиента на клиентском компьютере, перенаправив подключение на другой сервер, и имя экземпляра или комбинацию сервер:порт , не изменяя имя экземпляра на сервере.Alternatively, you can create a client alias name on the client computer, redirecting the connection to different server and instance name or server:port combination without changing the name of the instance on the server computer.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQLTopic link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

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

АргументыArguments

[ @server = ] 'server' — Имя сервера.[ @server = ] 'server' Is the name of the server. Имена серверов должны быть уникальными и соответствовать правилам именования MicrosoftMicrosoft Windows, за исключением того, что пробелы не допускаются.Server names must be unique and follow the rules for MicrosoftMicrosoft Windows computer names, although spaces are not allowed. Аргументserver имеет тип sysnameи не имеет значения по умолчанию.server is sysname, with no default.

Если на одном компьютере установлено несколько экземпляров SQL ServerSQL Server , то каждый экземпляр работает, как на отдельном сервере.When multiple instances of SQL ServerSQL Server are installed on a computer, an instance operates as if it is on a separate server. Указать именованный экземпляр, ссылаясь на server как имя_сервера\имя_экземпляра.Specify a named instance by referring to server as servername\instancename.

[ @local = ] 'LOCAL' Указывает, что сервер, который добавляется в качестве локального сервера.[ @local = ] 'LOCAL' Specifies that the server that is being added as a local server. @local** — varchar(10), значение по умолчанию NULL.@local** is varchar(10), with a default of NULL. Указание **@local** как ЛОКАЛЬНОГО определяет **@server** как имя локального сервера, а @ @@SERVERNAME функция, возвращающая значение из сервера.Specifying **@local** as LOCAL defines **@server** as the name of the local server and causes the @@SERVERNAME function to return the value of server.

Программа настройки SQL ServerSQL Server во время установки присваивает этой переменной в качестве значения имя компьютера.SQL ServerSQL Server Setup sets this variable to the computer name during installation. По умолчанию при подключении пользователей к экземпляру SQL ServerSQL Server используется имя компьютера, и никакая дополнительная настройка не требуется.By default, the computer name is the way users connect to an instance of SQL ServerSQL Server without requiring additional configuration.

Локальное переопределение вступает в силу только после перезагрузки компонента Компонент Database EngineDatabase Engine .The local definition takes effect only after the Компонент Database EngineDatabase Engine is restarted. На каждом экземпляре компонента Компонент Database EngineDatabase Engineможет быть определен только один локальный сервер.Only one local server can be defined in each instance of the Компонент Database EngineDatabase Engine.

[ @duplicate_ok = ] 'duplicate_OK' Указывает, разрешено ли совпадение имен серверов.[ @duplicate_ok = ] 'duplicate_OK' Specifies whether a duplicate server name is allowed. @duplicate_OK** — varchar(13), значение по умолчанию NULL.@duplicate_OK** is varchar(13), with a default of NULL. @duplicate_OK** может иметь только значение duplicate_OK или значение NULL.@duplicate_OK** can only have the value duplicate_OK or NULL. Если duplicate_OK указан и имя сервера, который добавляется уже существует, ошибка не возникает.If duplicate_OK is specified and the server name that is being added already exists, no error is raised. Если именованные параметры не используются, **@local** должен быть указан.If named parameters are not used, **@local** must be specified.

Значения кода возвратаReturn Code Values

0 (успешное завершение) или 1 (неуспешное завершение)0 (success) or 1 (failure)

ПримечанияRemarks

Чтобы задать или Очистить параметры сервера, используйте sp_serveroption.To set or clear server options, use sp_serveroption.

sp_addserver нельзя использовать внутри пользовательской транзакции.sp_addserver cannot be used inside a user-defined transaction.

С помощью sp_addserver для добавления удаленного сервера более не поддерживается.Using sp_addserver to add a remote server is discontinued. Вместо этого используйте хранимую процедуру sp_addlinkedserver .Use sp_addlinkedserver instead.

РазрешенияPermissions

Требует членства в предопределенной роли сервера setupadmin .Requires membership in the setupadmin fixed server role.

ПримерыExamples

В следующем примере запись компонента Компонент Database EngineDatabase Engine , содержащая имя компьютера, на котором размещается SQL ServerSQL Server , изменяется на ACCOUNTS.The following example changes the Компонент Database EngineDatabase Engine entry for the name of the computer hosting SQL ServerSQL Server to ACCOUNTS.

sp_addserver 'ACCOUNTS', 'local';  

См. такжеSee Also

Переименование компьютера, на который установлен изолированный экземпляр SQL Server Rename a Computer that Hosts a Stand-Alone Instance of SQL Server
sp_addlinkedserver (Transact-SQL) sp_addlinkedserver (Transact-SQL)
sp_dropserver (Transact-SQL) sp_dropserver (Transact-SQL)
sp_helpserver (Transact-SQL) sp_helpserver (Transact-SQL)
Системные хранимые процедуры (Transact-SQL) System Stored Procedures (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)Security Stored Procedures (Transact-SQL)