sys.sp_addserver (Transact-SQL)

platí pro:SQL Server

Definuje název lokální instance SQL Server. Když je hostitelský SQL Server přejmenován, použijte to sp_addserver k informování instance Databázový stroj systému SQL Server o novém názvu počítače. Tento postup musí být proveden na všech instancích Database Engine hostovaných na počítači.

Název instance Database Engine nelze změnit. Pro změnu názvu instance pojmenované instance nainstalujte novou instanci s požadovaným názvem, odpojte databázové soubory od staré instance, připojte databáze k nové instanci a starou instanci zrušte. Alternativně můžete na klientském počítači vytvořit jméno klientského aliasu, přesměrovat spojení na jiný server a název nebo <server>:<port> kombinaci instance, aniž byste měnili název instance na serverovém počítači.

Transact-SQL konvence syntaxe

Syntax

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

Arguments

[ @server = ] N' server'

Název serveru. Názvy serverů musí být jedinečné a dodržovat pravidla pro názvy počítačů Windows, i když mezery nejsou povoleny. @server je sysname , bez výchozího nastavení.

Když je na počítači nainstalováno více instancí SQL Server, instance funguje, jako by byla na samostatném serveru. Specifikujte pojmenovanou instanci odkazem na @server jako <servername>\<instancename>.

[ @local = ] 'MÍSTNÍ'

Specifikuje, že server je přidáván jako lokální server. @local je varchar(10), s výchozím hodnotou NULL. Zadání @local as LOCAL definuje @server jako název lokálního serveru a způsobí @@SERVERNAME , že funkce vrátí hodnotu @server.

SQL Server Setup nastaví tuto proměnnou na název počítače během instalace. Ve výchozím nastavení je název počítače způsob, jakým se uživatelé připojují k instanci SQL Server bez nutnosti další konfigurace.

Lokální definice nabývá účinnosti až po restartu Database Engine. V každé instanci Database Engine lze definovat pouze jeden lokální server.

[ @duplicate_ok = ] 'duplicate_OK'

Specifikuje, zda je povoleno použít duplicitní název serveru. @duplicate_ok je varchar(13), s výchozím hodnotou NULL. @duplicate_ok může mít pouze hodnotu duplicate_OK nebo NULL. Pokud je @duplicate_ok specifikováno a přidávané jméno serveru již existuje, chyba se neobjeví. Pokud nejsou použity pojmenované parametry, musí být @local specifikovány.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Poznámky

Pro nastavení nebo vymazání možností serveru použijte sp_serveroption.

sp_addserver nelze použít v uživatelsky definované transakci.

Používání sp_addserver vzdáleného serveru je ukončeno. Použijte místo toho sp_addlinkedserver .

Použití sp_addserver změny názvu lokálního serveru může způsobit nežádoucí efekty nebo nepodporované konfigurace při použití skupin dostupnosti nebo replikace.

Permissions

Vyžaduje členství v roli fixního serveru setupadmin .

Examples

Následující příklad mění záznam Database Engine pro název počítače, který hostuje SQL Server, na ACCOUNTS.

EXECUTE sp_addserver 'ACCOUNTS', 'local';

Související obsah

  • Last updated on