Хранимая процедура sp_setnetname (Transact-SQL)sp_setnetname (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

Присваивает сетевым именам sys.servers для их фактического сетевые имена компьютеров для удаленных экземпляров SQL ServerSQL Server.Sets the network names in sys.servers to their actual network computer names for remote instances of SQL ServerSQL Server. Эта процедура может быть использована для разрешения выполнения вызовов удаленных хранимых процедур тем компьютерам, сетевые имена которых содержат неверные идентификаторы SQL ServerSQL Server.This procedure can be used to enable execution of remote stored procedure calls to computers that have network names containing SQL ServerSQL Server identifiers that are not valid.

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

СинтаксисSyntax

  
sp_setnetname  
@server = 'server',   
     @netname = 'network_name'  

АргументыArguments

@server = " server "@server = ' server '
Имя удаленного сервера в синтаксисе вызова удаленных хранимых процедур, написанных пользователем.Is the name of the remote server as referenced in user-coded remote stored procedure call syntax. Ровно одна строка в sys.servers уже должен существовать для этого сервера.Exactly one row in sys.servers must already exist to use this server. Аргументserver имеет тип sysnameи не имеет значения по умолчанию.server is sysname, with no default.

@netname = " сетевое_имя "@netname =' network_name '
Сетевое имя компьютера, на который направляются вызовы удаленных хранимых процедур.Is the network name of the computer to which remote stored procedure calls are made. сетевое_имяsysname, не имеет значения по умолчанию.network_name is sysname, with no default.

Это имя должно совпадать с именем компьютера MicrosoftMicrosoft Windows и может содержать символы, использование которых в качестве идентификаторов SQL ServerSQL Server запрещено.This name must match the MicrosoftMicrosoft Windows computer name, and the name can include characters that are not allowed in SQL ServerSQL Server identifiers.

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

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

Результирующие наборыResult Sets

NoneNone

ПримечанияRemarks

Некоторые удаленные хранимые процедуры, обращающиеся к Windows-компьютерам, могут вызвать проблемы, если имя компьютера содержит недопустимые символы.Some remote stored procedure calls to Windows computers can encounter problems if the computer name contains identifiers that are not valid.

Так как связанные серверы размещены в одном пространстве имен, они не могут иметь одинаковое имя.Because linked servers and remote servers reside in the same namespace, they cannot have the same name. Тем не менее, можно определить как связанный сервер, так и удаленный сервер на определенных серверах, присваивая им различные имена и используя sp_setnetname для присвоения сетевого имени одного из них сетевому имени базового сервера.However, you can define both a linked server and a remote server against a specified server by assigning different names and by using sp_setnetname to set the network name of one of them to the network name of the underlying server.

--Assume sqlserv2 is actual name of SQL Server   
--database server  
EXEC sp_addlinkedserver 'sqlserv2';  
GO  
EXEC sp_addserver 'rpcserv2';  
GO  
EXEC sp_setnetname 'rpcserv2', 'sqlserv2';  

Примечание

С помощью sp_setnetname указывают связанный сервер на локальном сервере не поддерживается.Using sp_setnetname to point a linked server back to the local server is not supported. Серверы, которые описаны таким образом, не могут участвовать в распределенной транзакции.Servers that are referenced in this manner cannot participate in a distributed transaction.

РазрешенияPermissions

Требуется членство в sysadmin и setupadmin предопределенных ролей сервера.Requires membership in the sysadmin and setupadmin fixed server roles.

ПримерыExamples

В следующем примере показана типичная административная последовательность, используемая в SQL ServerSQL Server для вызова удаленной хранимой процедуры.The following example shows a typical administrative sequence used on SQL ServerSQL Server to issue the remote stored procedure call.

USE master;  
GO  
EXEC sp_addserver 'Win_1';  
EXEC sp_setnetname 'Win_1','Win-1';  
EXEC Win_1.master.dbo.sp_who;  

См. такжеSee Also

Хранимым процедурам ядра СУБД (Transact-SQL) Database Engine Stored Procedures (Transact-SQL)
sp_addlinkedserver (Transact-SQL) sp_addlinkedserver (Transact-SQL)
sp_addserver (Transact-SQL) sp_addserver (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)System Stored Procedures (Transact-SQL)