sp_addserver (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 執行個體的方法。

  本機定義必須等伺服器關機再重新啟動之後才會生效。每一部伺服器只能定義一部本機伺服器。

• [ @duplicate_ok = ] 'duplicate_OK'
  指定是否允許重複的伺服器名稱。@duplicate_OK 是 varchar(13)，預設值是 NULL。@duplicate_OK 的值只能為 duplicate_OK 或 NULL。如果是指定 duplicate_OK，而且正在加入的伺服器名稱已存在，就不會發生任何錯誤。如果沒有使用具名參數，就必須指定 @local。

傳回碼值

0 (成功) 或 1 (失敗)

備註

若要在執行舊版 SQL Server 的遠端伺服器上執行預存程序 (遠端程序呼叫)，請使用 sp_addserver 加入這部遠端伺服器。若要在執行 SQL Server 7.0 版或更新版的遠端伺服器上，執行預存程序或任何分散式查詢，請使用 sp_addlinkedserver 加入這部伺服器。

若要設定或清除伺服器選項，請使用 sp_serveroption。

sp_addserver 無法在使用者自訂交易內執行。

權限

需要 setupadmin 固定伺服器角色中的成員資格。

範例

下列範例會在本機伺服器上，建立一個遠端伺服器 ACCOUNTS 項目。

sp_addserver 'ACCOUNTS';

請參閱

工作

參考