sp_addserver (Transact-SQL)

[アーティクル]
12/15/2008

更新 : 2005 年 12 月 5 日

SQL Server のローカルインスタンスの名前を定義します。このストアドプロシージャではリモートサーバーも定義できます。

メモ :
リモートサーバーの機能は、次のバージョンの SQL Server では削除される予定です。リンクサーバーを定義するには、代わりに sp_addlinkedserver を使用してください。

トピックリンクアイコン Transact-SQL 構文表記規則

構文

sp_addserver [ @server = ] 'server' 
     [ , [ @local= ] 'local' ] 
     [ , [ @duplicate_ok = ] 'duplicate_OK' ]

引数

[ @server = ] 'server'
サーバーの名前を指定します。サーバー名は一意で、Microsoft Windows のコンピュータ名の規則に従っている必要があります。ただし、スペースは使用できません。server のデータ型は sysname で、既定値はありません。

SQL Server の複数のインスタンスがコンピュータにインストールされている場合、インスタンスは別のサーバー上にあるように動作します。server を servername\instancename として参照し、名前付きのインスタンスを指定します。

[ @local = ] 'LOCAL'
追加するサーバーがローカルサーバーであるか、リモートサーバーであるかを指定します。@local のデータ型は varchar(10) で、既定値は NULL です。@local を LOCAL として指定すると、@server はローカルサーバーの名前として定義され、@@SERVERNAME 関数では server の値が返されるようになります。

インストール中、SQL Server セットアップによってこの変数がコンピュータ名に設定されます。この名前は変更しないことをお勧めします。既定では、追加構成を行うことなく、ユーザーはこのコンピュータ名を使用して SQL Server インスタンスに接続できます。

ローカル定義は、サーバーをシャットダウンし再起動した後に有効になります。各サーバーでは 1 つのローカルサーバーだけを定義できます。

[ @duplicate_ok = ] 'duplicate_OK'
重複するサーバー名を許可するかどうかを指定します。@duplicate_OK のデータ型は varchar(13) で、既定値は NULL です。@duplicate_OK に設定できる値は、duplicate_OK または NULL のいずれかです。duplicate_OK を指定した場合、追加するサーバー名が既に存在していても、エラーは発生しません。名前付きのパラメータを指定しない場合は、@local を指定する必要があります。

解説

以前のバージョンの SQL Server を実行しているリモートサーバー上でストアドプロシージャを実行する (リモートプロシージャを呼び出す) 場合は、sp_addserver を使用してリモートサーバーを追加します。SQL Server バージョン 7.0 以降を実行しているリモートサーバーで、ストアドプロシージャ、または任意の分散クエリを実行する場合は、sp_addlinkedserver を使用してサーバーを追加します。

サーバーオプションを設定または解除するには、sp_serveroption を使用します。

ユーザーが定義したトランザクション内では、sp_addserver は実行できません。

権限

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

戻り値

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

例

次の例では、リモートサーバー ACCOUNTS のエントリをローカルサーバーに作成します。

sp_addserver 'ACCOUNTS';

参照

その他の技術情報

SQL Server 2005 スタンドアロンインスタンスをホストするコンピュータの名前を変更する方法

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース	履歴
2005 年 12 月 5 日	変更内容 sp_addserver を使用してローカルサーバーの名前を定義する方法を明記。廃止予定の情報を修正。

次の方法で共有

sp_addserver (Transact-SQL)

構文

引数

解説

権限

戻り値

例

参照

関連項目

その他の技術情報

ヘルプおよび情報

変更履歴

その他のリソース