sp_setnetname (Transact-SQL)

Aplica-se a: simSQL Server (todas as versões compatíveis)

Define os nomes de rede em sys.servers para seus nomes de computador de rede reais para instâncias remotas do SQL 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 Server que não são válidos.

Ícone de link do tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

@server = ' servidor '
É o nome do servidor remoto conforme referenciado em sintaxe de chamada de procedimento armazenado remoto codificado pelo usuário. Exatamente uma linha em sys.servers já deve existir para usar esse servidor. server é sysname, sem padrão.

@netname =' network_name '
É o nome de rede do computador ao qual as chamadas de procedimento armazenado remoto são feitas. network_name é sysname, sem padrão.

Esse nome deve corresponder ao nome do computador de Microsoft Windows, e o nome pode incluir caracteres que não são permitidos em identificadores do SQL Server.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nenhum

Comentários

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.

Como servidores vinculados e servidores remotos residem no mesmo namespace, eles não podem ter o mesmo nome. No entanto, você pode definir um servidor vinculado e um servidor remoto em relação a um servidor especificado atribuindo nomes diferentes e usando sp_setnetname para definir o nome de rede de um deles para o nome de rede do servidor subjacente.

--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

Não há sp_setnetname para apontar um servidor vinculado de volta para o servidor local. Os servidores referenciados dessa maneira não podem participar de uma transação distribuída.

Permissões

Requer associação nas funções de servidor fixas sysadmin e setupadmin.

Exemplos

O exemplo a seguir mostra uma sequência administrativa típica usada no SQL Server para emitir a chamada de procedimento armazenado remoto.

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

Consulte Também

Mecanismo de Banco de Dados Procedimentos armazenados (transact-SQL)
sp_addlinkedserver (Transact-SQL)
sp_addserver (transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)