sp_addserver (Transact-SQL)

Article
08/19/2013

Définit le nom de l'instance locale de SQL Server. Lorsque l'ordinateur qui héberge SQL Server est renommé, utilisez sp_addserver pour informer l'instance du moteur de base de données SQL Server du nouveau nom d'ordinateur. Cette procédure doit être exécutée sur toutes les instances du moteur de base de données hébergé sur l'ordinateur. Le nom de l'instance du moteur de base de données ne peut pas être modifié.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @server = ] 'server'
Indique le nom du serveur. Les noms de serveurs doivent être uniques et suivre les règles de Microsoft Windows concernant les noms des ordinateurs, bien que l'utilisation d'espaces ne soit pas autorisée. server est de type sysname et n'a pas de valeur par défaut.

Lorsque plusieurs instances de SQL Server sont installées sur un ordinateur, chacune fonctionne comme si elle était sur un serveur distinct. Spécifiez une instance nommée en faisant référence à server en tant que servername\instancename.
[ @local = ] 'LOCAL'
Spécifie que le serveur est ajouté comme un serveur local. @local est de type varchar(10), avec NULL comme valeur par défaut. Si vous spécifiez @local avec la valeur LOCAL, @server est défini en tant que nom du serveur local, et la fonction @@SERVERNAME retourne la valeur de server.

Le programme d'installation de SQL Server affecte à cette variable le nom de l'ordinateur. Par défaut, le nom de l'ordinateur est la manière dont les utilisateurs se connectent à une instance de SQL Server sans configuration complémentaire.

La définition locale entre uniquement en vigueur une fois le moteur de base de données redémarré. Un seul serveur local peut être défini dans chaque instance du moteur de base de données.
[ @duplicate_ok = ] 'duplicate_OK'
Spécifie si les noms de serveur en double sont autorisés. L'argument @duplicate_OK est de type varchar(13), avec NULL comme valeur par défaut. @duplicate_OK ne peut avoir que la valeur duplicate_OK ou la valeur NULL. Si vous spécifiez duplicate_OK et que le nom de serveur ajouté existe déjà, il n'y a pas d'erreur. @local doit être spécifié si les paramètres nommés ne sont pas utilisés.