sp_addserver (Transact-SQL)

S’applique à : SQL Server (toutes les versions prises en charge)

Définit le nom de l’instance locale de SQL Server. Lorsque l’ordinateur hébergeant SQL Server est renommé, utilisez sp_addserver pour informer l’instance du moteur de base de données SQL Server du nouveau nom de l’ordinateur. Cette procédure doit être exécutée sur toutes les instances du moteur de base de données hébergée sur l’ordinateur. Le nom de l’instance du moteur de base de données ne peut pas être modifié. Pour modifier le nom d'une instance nommée, installez une nouvelle instance portant le nom souhaité, détachez les fichiers de base de données de l'ancienne instance, attachez les bases de données à la nouvelle instance, puis supprimez l'ancienne instance. Vous pouvez également créer un nom d'alias client sur l'ordinateur client, en redirigeant la connexion vers un autre nom de serveur et d'instance ou la combinaison serveur:port sans modifier le nom de l'instance sur l'ordinateur serveur.

Topic link iconConventions de la syntaxe Transact-SQL

Syntaxe


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

Arguments

[ @server = ] 'server' Nom du serveur. Les noms de serveur doivent être uniques et suivre les règles des noms d’ordinateurs Microsoft Windows, bien que les espaces ne soient pas autorisés. server est de type sysnameet n'a pas de valeur par défaut.

Lorsque plusieurs instances de SQL Server sont installées sur un ordinateur, une instance fonctionne comme si elle se trouve sur un serveur distinct. Spécifiez une instance nommée en faisant référence au serveur en tant que nom_serveur\nom_instance.

[ @local = ] 'LOCAL' Spécifie que le serveur qui est ajouté en tant que serveur local. @local est varchar(10), avec la valeur NULL 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.

SQL Server Programme d’installation définit cette variable sur le nom de l’ordinateur pendant l’installation. Par défaut, le nom de l’ordinateur est la façon dont les utilisateurs se connectent à une instance de SQL Server sans nécessiter de configuration supplémentaire.

La définition locale prend effet uniquement 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 un nom de serveur en double est autorisé. @duplicate_OK est varchar(13), avec la valeur NULL par défaut. @duplicate_OK ne peut avoir que la valeur duplicate_OK ou NULL. Si duplicate_OK est spécifié et que le nom du serveur qui est ajouté existe déjà, aucune erreur n’est générée. @local doit être spécifié si les paramètres nommés ne sont pas utilisés.

Codet de retour

0 (réussite) ou 1 (échec)

Notes

Pour définir ou effacer les options du serveur, utilisez sp_serveroption.

sp_addserver ne peut pas être utilisé à l’intérieur d’une transaction définie par l’utilisateur.

L’utilisation de sp_addserver pour ajouter un serveur distant est supprimée. Utilisez de préférence sp_addlinkedserver.

L’utilisation de sp_addserver pour modifier le nom du serveur local peut entraîner des effets non souhaités ou des configurations non prises en charge lors de l’utilisation de groupes de disponibilité ou de réplication.

Autorisations

Nécessite l'appartenance au rôle serveur fixe setupadmin .

Exemples

L’exemple suivant modifie l’entrée du moteur de base de données pour le nom de l’ordinateur hébergeant SQL Server sur ACCOUNTS.

sp_addserver 'ACCOUNTS', 'local';

Voir aussi

Renommez un ordinateur qui héberge une instance Stand-Alone de SQL Serversp_addlinkedserver (Transact-SQL)sp_dropserver (Transact-SQL)sp_helpserver (Transact-SQL)Procédures stockées système (Transact-SQL)Procédures stockées de sécurité (Transact-SQL)