sp_setnetname (Transact-SQL)

[アーティクル]
08/18/2022

適用対象:SQL Server (サポートされているすべてのバージョン)

sys.servers のネットワーク名を、SQL Serverのリモートインスタンスの実際のネットワークコンピューター名に設定します。このプロシージャを使用すると、無効なSQL Server識別子を含むネットワーク名を持つコンピューターに対するリモートストアドプロシージャ呼び出しを実行できます。

Topic link icon Transact-SQL 構文表記規則

構文

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

引数

@server = 'server'
ユーザーが作成したリモートストアドプロシージャ呼び出しの構文で参照しているリモートサーバーの名前を指定します。このサーバーを使用するには、sys.servers に 1 つの行が既に存在している必要があります。 server のデータ型は sysnameで、既定値はありません。

@netname ='network_name'
リモートストアドプロシージャ呼び出しが行われるコンピューターのネットワーク名です。 network_name は sysname で、既定値はありません。

この名前は Microsoft Windows コンピューター名と一致する必要があり、名前にはSQL Server識別子で使用できない文字を含めることができます。

リターンコードの値

0 (成功) または 1 (失敗)

結果セット

なし

解説

コンピューター名に無効な識別子が含まれている場合、Windows コンピューターへの一部のリモートストアドプロシージャ呼び出しで問題が発生する可能性があります。

リンクサーバーとリモートサーバーは同じ名前空間に存在するため、同じ名前にはできません。ただし、異なる名前を割り当て、 sp_setnetname を使用していずれかのネットワーク名を基になるサーバーのネットワーク名に設定することで、指定したサーバーに対してリンクサーバーとリモートサーバーの両方を定義できます。

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

Note

sp_setnetnameを使用してリンクサーバーをローカルサーバーに戻す方法はサポートされていません。この方法で参照されるサーバーは、分散トランザクションに参加できません。

アクセス許可

sysadmin と setupadmin 固定サーバーロールのメンバーシップが必要です。

例

次の例は、リモートストアドプロシージャ呼び出しを発行するためにSQL Serverで使用される一般的な管理シーケンスを示しています。

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

sp_setnetname (Transact-SQL)

構文

引数

リターン コードの値

結果セット

解説

アクセス許可

例

関連項目

リターンコードの値