sp_addremotelogin (Transact-SQL)

ローカルサーバーに新しいリモートログイン ID を追加します。これにより、リモートサーバーがリモートプロシージャ呼び出しに接続して、これを実行できるようなります。

メモ :
この機能は、Microsoft SQL Server の次のバージョンで削除されます。新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションはできるだけ早く修正してください。代わりに、リンクサーバーおよびリンクサーバーのストアドプロシージャを使用してください。

この機能は、Microsoft SQL Server の次のバージョンで削除されます。新規の開発作業ではこの機能を使用しないようにし、現在この機能を使用しているアプリケーションはできるだけ早く修正してください。代わりに、リンクサーバーおよびリンクサーバーのストアドプロシージャを使用してください。

構文

sp_addremotelogin [ @remoteserver = ] 'remoteserver' 
     [ , [ @loginame = ] 'login' ] 
          [ , [ @remotename = ] 'remote_name' ]

[ @remoteserver = ] 'remoteserver'
リモートログインが適用されるリモートサーバーの名前を指定します。remoteserver のデータ型は sysname で、既定値はありません。remoteserver だけを指定した場合、remoteserver のすべてのユーザーがローカルサーバーで同じ名前の既存のログインにマップされます。このサーバーは、ローカルサーバーが認識している必要があります。サーバーは、sp_addserver を使用して追加されます。remoteserver のユーザーが SQL Server を実行するローカルサーバーに接続して、リモートストアドプロシージャを実行する場合、remoteserver での自分のログインと一致するローカルログインとして接続します。remoteserver はリモートプロシージャ呼び出しを開始するサーバーです。

[ @loginame = ] 'login'
SQL Server のローカルインスタンスにおけるユーザーのログイン ID を指定します。login のデータ型は sysname で、既定値は NULL です。loginは、SQL Server のローカルインスタンス上に存在している必要があります。login を指定した場合、remoteserver のすべてのユーザーが特定のローカルログインにマップされます。remoteserver のユーザーが SQL Server のローカルインスタンスに接続して、リモートストアドプロシージャを実行する場合は、login として接続されます。

[ @remotename = ] 'remote_name'
リモートサーバーにおけるユーザーのログイン ID を指定します。remote_name のデータ型は sysname で、既定値は NULL です。remote_name は、remoteserver 上に存在している必要があります。remote_name を指定した場合、特定のユーザー remote_name がローカルサーバー上での login にマップされます。remoteserver の remote_name が SQL Server のローカルインスタンスに接続して、リモートストアドプロシージャを実行する場合は、login として接続されます。remote_name のログイン ID は、リモートサーバー上でのログイン ID login と異なっていてもかまいません。

分散クエリを実行するには、sp_addlinkedsrvlogin を使用します。

sp_addremotelogin をユーザー定義のトランザクションの内部で使用することはできません。

sp_addremotelogin を実行できるのは、固定サーバーロール sysadmin および securityadmin のメンバだけです。

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

次の例では、リモートサーバー ACCOUNTS とローカルサーバーが同じユーザーログインを持つ場合、リモート名をローカル名にマップします。

EXEC sp_addremotelogin 'ACCOUNTS';

次の例では、リモートサーバー ACCOUNTS のすべてのユーザーを、ローカル ID Albert にマップするエントリを作成します。

EXEC sp_addremotelogin 'ACCOUNTS', 'Albert';

次の例では、リモートサーバー ACCOUNTS のリモートユーザー Chris からローカルユーザー salesmgr に、リモートログインをマップします。

EXEC sp_addremotelogin 'ACCOUNTS', 'salesmgr', 'Chris';