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