sp_setnetname (Transact-SQL)sp_setnetname (Transact-SQL)

APLICA-SE A: simSQL Server nãoBanco de Dados SQL do Azure nãoAzure Synapse Analytics (SQL DW) nãoParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Define os nomes de rede no sys. Servers para seus nomes de computador de rede reais para instâncias remotas do SQL ServerSQL Server.Sets the network names in sys.servers to their actual network computer names for remote instances of SQL ServerSQL Server. Este procedimento pode ser usado para habilitar a execução de chamadas de procedimento armazenado remoto para computadores com nomes de rede contendo identificadores do SQL ServerSQL Server que não são válidos.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.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

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

ArgumentosArguments

@server = ' server '@server = ' server '
É o nome do servidor remoto conforme referenciado em sintaxe de chamada de procedimento armazenado remoto codificado pelo usuário.Is the name of the remote server as referenced in user-coded remote stored procedure call syntax. Exatamente uma linha em sys. Servers já deve existir para usar esse server.Exactly one row in sys.servers must already exist to use this server. server é sysname, sem padrão.server is sysname, with no default.

@netname =' network_name '@netname =' network_name '
É o nome de rede do computador ao qual as chamadas de procedimento armazenado remoto são feitas.Is the network name of the computer to which remote stored procedure calls are made. network_name está sysname, sem padrão.network_name is sysname, with no default.

Esse nome deve corresponder ao nome do computador de MicrosoftMicrosoft Windows, e o nome pode incluir caracteres que não são permitidos em identificadores do 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.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

NenhumNone

ComentáriosRemarks

Algumas chamadas de procedimento armazenado remoto a computadores com Windows podem encontrar problemas se o nome do computador tiver identificadores que não são válidos.Some remote stored procedure calls to Windows computers can encounter problems if the computer name contains identifiers that are not valid.

Como servidores vinculados e servidores remotos residem no mesmo namespace, eles não podem ter o mesmo nome.Because linked servers and remote servers reside in the same namespace, they cannot have the same name. No entanto, você pode definir um servidor vinculado e um servidor remoto em um servidor especificado, atribuindo nomes diferentes e usando sp_setnetname para definir o nome da rede de um deles como o nome de rede do servidor subjacente.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';  

Observação

Usando o sp_setnetname apontar um servidor vinculado para o servidor local não tem suporte.Using sp_setnetname to point a linked server back to the local server is not supported. Os servidores referenciados dessa maneira não podem participar de uma transação distribuída.Servers that are referenced in this manner cannot participate in a distributed transaction.

PermissõesPermissions

Requer associação na sysadmin e setupadmin funções de servidor fixas.Requires membership in the sysadmin and setupadmin fixed server roles.

ExemplosExamples

O exemplo a seguir mostra uma sequência administrativa típica usada no SQL ServerSQL Server para emitir a chamada de procedimento armazenado remoto.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;  

Consulte tambémSee Also

Procedimentos armazenados do mecanismo de banco de dados (Transact-SQL) Database Engine Stored Procedures (Transact-SQL)
sp_addlinkedserver (Transact-SQL) sp_addlinkedserver (Transact-SQL)
sp_addserver (Transact-SQL) sp_addserver (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)System Stored Procedures (Transact-SQL)