sp_addserver (Transact-SQL)
SQL Server のローカル インスタンスの名前を定義します。 SQL Server をホストしているコンピューターの名前を変更した場合は、sp_addserver を使用して、SQL Server データベース エンジンのインスタンスに新しいコンピューター名を知らせます。 このプロシージャは、コンピューターでホストされている、データベース エンジンのすべてのインスタンスで実行する必要があります。 データベース エンジンのインスタンスの名前は変更できません。
.gif "トピック リンク アイコン")
構文
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 を指定する必要があります。
リターン コード値
0 (成功) または 1 (失敗)
説明
サーバー オプションを設定または解除するには、sp_serveroption を使用します。
ユーザーが定義したトランザクション内では、sp_addserver は実行できません。
sp_addserver を使用してリモート サーバーを追加する方法は廃止されます。 代わりに、sp_addlinkedserver を使用してください。
権限
setupadmin 固定サーバー ロールのメンバーシップが必要です。
使用例
次の例では、SQL Server をホストしているコンピューターの名前のデータベース エンジン エントリを ACCOUNTS に変更します。
sp_addserver 'ACCOUNTS', 'local';
関連項目
タスク
SQL Server のスタンドアロン インスタンスをホストするコンピューターの名前変更
参照
sp_addlinkedserver (Transact-SQL)