sp_addremotelogin (Transact-SQL)
適用対象: 
SQL サーバー
ローカル サーバーに新しいリモート ログイン ID を追加します。 これにより、リモート サーバーはリモート プロシージャ コールに接続して実行できます。
重要
この機能は、 SQL Serverの将来のバージョンで削除される予定です。 新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションは修正することを検討してください。 代わりに、リンク サーバーとリンク サーバー ストアド プロシージャを使用してください。
構文
sp_addremotelogin
[ @remoteserver = ] N'remoteserver'
[ , [ @loginame = ] N'loginame' ]
[ , [ @remotename = ] N'remotename' ]
[ ; ]
引数
[ @remoteserver = ] N'remoteserver'
リモート ログインが適用されるリモート サーバーの名前。 @remoteserver は sysname で、既定値はありません。 @remoteserverのみを指定した場合、@remoteserver上のすべてのユーザーは、ローカル サーバー上の同じ名前の既存のログインにマップされます。 このサーバーは、ローカル サーバーが認識している必要があります。 これは、 sp_addserverを使用して追加されます。 @remoteserverのユーザーは、SQL Server を実行しているローカル サーバーに接続してリモート ストアド プロシージャを実行すると、@remoteserverでの独自のログインと一致するローカル ログインとして接続します。 @remoteserver は、リモート プロシージャ コールを開始するサーバーです。
[ @loginame = ] N'loginame'
SQL Server のローカル インスタンス上のユーザーのログイン ID。 @loginame は sysname で、既定値は NULL です。 @loginame は、SQL Server のローカル インスタンスに既に存在している必要があります。 @loginameを指定すると、@remoteserverのすべてのユーザーがその特定のローカル ログインにマップされます。 @remoteserverのユーザーが SQL Server のローカル インスタンスに接続してリモート ストアド プロシージャを実行すると、@loginameとして接続されます。
[ @remotename = ] N'remotename'
リモート サーバー上のユーザーのログイン ID。 @remotename は sysname で、既定値は NULL です。 @remotename@remoteserverに存在する必要があります。 @remotenameを指定すると、特定のユーザー @remotenameがローカル サーバー上の@loginameにマップされます。 @remoteserverの@remotenameが SQL Server のローカル インスタンスに接続してリモート ストアド プロシージャを実行すると、@loginameとして接続されます。 @remotenameのログイン ID は、リモート サーバーのログイン ID (@loginame) とは異なる場合があります。
リターン コードの値
0 (成功) または 1 (失敗)。
解説
分散クエリを実行するには、 sp_addlinkedsrvloginを使用します。
sp_addremotelogin は、ユーザー定義トランザクション内では使用できません。
アクセス許可
sysadminおよびsecurityadmin固定サーバー ロールのメンバーのみがsp_addremoteloginを実行できます。
例
A. 1 つを 1 つにマップする
次の例では、リモート サーバー ACCOUNTS とローカル サーバーに同じユーザー ログインがある場合に、リモート名をローカル名にマップします。
EXEC sp_addremotelogin 'ACCOUNTS';
B. 多くを 1 にマップする
次の例では、リモート サーバー ACCOUNTS のすべてのユーザーを、ローカル ID Albert にマップするエントリを作成します。
EXEC sp_addremotelogin 'ACCOUNTS', 'Albert';
C: 明示的な 1 対 1 のマッピングを使用する
次の例では、リモート サーバー ACCOUNTS上のリモート ユーザー Chrisからのリモート ログインをローカル ユーザー salesmgrにマップします。
EXEC sp_addremotelogin 'ACCOUNTS', 'salesmgr', 'Chris';
関連するコンテンツ
- sp_addlinkedsrvlogin (Transact-SQL)
- sp_addlogin (Transact-SQL)
- sp_addserver (Transact-SQL)
- sp_dropremotelogin (Transact-SQL)
- sp_grantlogin (Transact-SQL)
- sp_helpremotelogin (Transact-SQL)
- sp_helpserver (Transact-SQL)
- sp_remoteoption (Transact-SQL)
- sp_revokelogin (Transact-SQL)
- システム ストアド プロシージャ (Transact-SQL)