sys.sp_addserver (Transact-SQL)

A következőkre vonatkozik:SQL Server

Definiálja az SQL Server helyi példányának nevét. Amikor az SQL Server-t üzemeltető számítógépet átnevezik, ezt sp_addserver az SQL Server adatbázismotor példányának az új számítógépnév megszólalására használjuk. Ezt az eljárást a számítógépen található Database Engine összes példányán kell végrehajtani.

A Database Engine példány neve nem változtatható. A névnevű példány neve megváltoztatásához telepíts egy új példányt a kívánt névvel, leválasztjuk az adatbázisfájlokat a régi példányról, csatoljuk az adatbázisokat az új példányhoz, és hagyd el a régi példányt. Alternatívaként létrehozhatsz egy kliens alias nevet a kliens számítógépen, így a kapcsolatot átirányítva különböző szerver- és példánynévvel vagy <server>:<port> kombinációval anélkül, hogy megváltoztatnád a példány nevét a szerver számítógépén.

Transact-SQL szintaxis konvenciók

Syntax

sys.sp_addserver
    [ @server = ] N'server'
    [ , [ @local = ] 'LOCAL' ]
    [ , [ @duplicate_ok = ] 'duplicate_OK' ]
[ ; ]

Arguments

[ @server = ] N'kiszolgáló'

A kiszolgáló neve. A szerverneveknek egyedinek kell lenniük, és megfelelniük kell a Windows számítógépnevek szabályainak, bár a szóközek nem engedélyezettek. @serversysname, alapértelmezés nélkül.

Ha több SQL Server példányt telepítenek egy számítógépre, egy példány úgy működik, mintha egy külön szerveren lenne. Határozz meg egy nevelt példányt úgy, hogy @server a következőképpen <servername>\<instancename>hivatkozzunk .

[ @local = ] 'HELYI'

Megadja, hogy a szervert helyi szerverként adják hozzá. @localvarchar(10), alapértelmezett értéke NULL. Ha @local megadjuk úgy LOCAL , hogy @server a helyi szerver neve, és a @@SERVERNAME függvény a @server értéket adja vissza.

Az SQL Server Setup telepítés során ezt a változót a számítógép nevére állítja be. Alapértelmezés szerint a számítógép neve az, ahogyan a felhasználók csatlakoznak egy SQL Server példányhoz további konfiguráció nélkül.

A helyi definíció csak akkor lép életbe, amikor a Database Engine újraindított. Minden Database Engine példányban csak egy helyi szerver definiálható.

[ @duplicate_ok = ] 'duplicate_OK'

Megadja, hogy engedélyezett-e egy duplikált szervernév. @duplicate_oka varchar(13), alapértelmezett értéke NULL. @duplicate_ok csak az duplicate_OK értéket vagy NULL-t kaphatják. Ha @duplicate_ok meg van adva, és a hozzáadott szervernév már létezik, nem keletkezik hiba. Ha nem használnak elnevezett paramétereket, @local meg kell határozni.

Kódértékek visszaadása

0 (sikeres) vagy 1 (hiba).

Remarks

Szerver beállítások beállításához vagy törléséhez használd sp_serveroption.

sp_addserver nem használható felhasználó által definiált tranzakcióban.

A távoli szerver hozzáadásának használata sp_addserver megszűnt. Használj inkább sp_addlinkedserver .

sp_addserver A helyi szervernév megváltoztatása nem kívánt hatásokat vagy támogatatlan konfigurációkat okozhat elérhetőségi csoportok vagy replikáció használata során.

Permissions

Tagság szükséges a setupadmin fix szerver szerepben.

Examples

A következő példa megváltoztatja az SQL Server-t üzemeltető számítógép nevének Database Engine bejegyzését .ACCOUNTS

EXECUTE sp_addserver 'ACCOUNTS', 'local';

Kapcsolódó tartalom

  • Last updated on