sp_addserver (Transact-SQL)sp_addserver (Transact-SQL)

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)nonAzure SQL DatabasenonAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Définit le nom de l’instance locale de SQL ServerSQL Server.Defines the name of the local instance of SQL ServerSQL Server. Lorsque l’ordinateur qui héberge SQL ServerSQL Server est renommé, utilisez sp_addserver pour informer l’instance de la Moteur de base de données SQL ServerSQL Server Database Engine du nouveau nom d’ordinateur.When the computer hosting SQL ServerSQL Server is renamed, use sp_addserver to inform the instance of the Moteur de base de données SQL ServerSQL Server Database Engine of the new computer name. Cette procédure doit être exécutée sur toutes les instances de la Moteur de base de donnéesDatabase Engine hébergé sur l’ordinateur.This procedure must be executed on all instances of the Moteur de base de donnéesDatabase Engine hosted on the computer. Le nom de l’instance de la Moteur de base de donnéesDatabase Engine ne peut pas être modifié.The instance name of the Moteur de base de donnéesDatabase Engine cannot be changed. 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.To change the instance name of a named instance, install a new instance with the desired name, detach the database files from old instance, attach the databases to the new instance and drop the old 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.Alternatively, you can create a client alias name on the client computer, redirecting the connection to different server and instance name or server:port combination without changing the name of the instance on the server computer.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax


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

ArgumentsArguments

[ @server = ] 'server'[ @server = ] 'server'
Indique le nom du serveur.Is the name of the server. Les noms de serveurs doivent être uniques et suivre les règles de MicrosoftMicrosoft Windows concernant les noms des ordinateurs, bien que l'utilisation d'espaces ne soit pas autorisée.Server names must be unique and follow the rules for MicrosoftMicrosoft Windows computer names, although spaces are not allowed. server est de type sysnameet n'a pas de valeur par défaut.server is sysname, with no default.

Lorsque plusieurs instances de SQL ServerSQL Server sont installés sur un ordinateur, chacune fonctionne comme s’il se trouve sur un serveur distinct.When multiple instances of SQL ServerSQL Server are installed on a computer, an instance operates as if it is on a separate server. Spécifier une instance nommée en faisant référence à server en tant que nomserveur\nominstance.Specify a named instance by referring to server as servername\instancename.

[ @local = ] 'LOCAL'[ @local = ] 'LOCAL'
Spécifie que le serveur est ajouté comme un serveur local.Specifies that the server that is being added as a local server. @local est varchar (10), avec NULL comme valeur par défaut.@local is varchar(10), with a default of NULL. Spécification de @local en tant que LOCAL définit @server en tant que le nom du serveur local et le @@SERVERNAME fonction pour retourner la valeur de server.Specifying @local as LOCAL defines @server as the name of the local server and causes the @@SERVERNAME function to return the value of server.

Le programme d'installation de SQL ServerSQL Server affecte à cette variable le nom de l'ordinateur. SQL ServerSQL Server Setup sets this variable to the computer name during installation. Par défaut, le nom d’ordinateur est les manière dont les utilisateurs se connectent à une instance de SQL ServerSQL Server sans configuration supplémentaire nécessaire.By default, the computer name is the way users connect to an instance of SQL ServerSQL Server without requiring additional configuration.

La définition locale entre en vigueur qu’après le Moteur de base de donnéesDatabase Engine est redémarré.The local definition takes effect only after the Moteur de base de donnéesDatabase Engine is restarted. Seul un serveur local peut être défini dans chaque instance de la Moteur de base de donnéesDatabase Engine.Only one local server can be defined in each instance of the Moteur de base de donnéesDatabase Engine.

[ @duplicate_ok = ] 'duplicate_OK'[ @duplicate_ok = ] 'duplicate_OK'
Spécifie si les noms de serveur en double sont autorisés.Specifies whether a duplicate server name is allowed. @duplicate_OK est varchar(13), avec NULL comme valeur par défaut.@duplicate_OK is varchar(13), with a default of NULL. @duplicate_OK peut avoir uniquement la valeur duplicate_OK ou NULL.@duplicate_OK can only have the value duplicate_OK or NULL. Si duplicate_OK est spécifié et le nom du serveur qui est déjà ajouté existe, aucune erreur n’est levée.If duplicate_OK is specified and the server name that is being added already exists, no error is raised. Si les paramètres nommés ne sont pas utilisés, @local doit être spécifié.If named parameters are not used, @local must be specified.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

Pour définir ou désactivez les options de serveur, utilisez sp_serveroption.To set or clear server options, use sp_serveroption.

sp_addserver ne peut pas être utilisé à l’intérieur d’une transaction définie par l’utilisateur.sp_addserver cannot be used inside a user-defined transaction.

À l’aide de sp_addserver pour ajouter un serveur distant n’est plus disponible.Using sp_addserver to add a remote server is discontinued. Utilisez de préférence sp_addlinkedserver .Use sp_addlinkedserver instead.

AutorisationsPermissions

Nécessite l'appartenance au rôle serveur fixe setupadmin .Requires membership in the setupadmin fixed server role.

ExemplesExamples

L’exemple suivant modifie le Moteur de base de donnéesDatabase Engine entrée pour le nom de l’ordinateur hébergeant SQL ServerSQL Server à ACCOUNTS.The following example changes the Moteur de base de donnéesDatabase Engine entry for the name of the computer hosting SQL ServerSQL Server to ACCOUNTS.

sp_addserver 'ACCOUNTS', 'local';  

Voir aussiSee Also

Renommer un ordinateur qui héberge une Instance autonome de SQL Server Rename a Computer that Hosts a Stand-Alone Instance of SQL Server
sp_addlinkedserver (Transact-SQL) sp_addlinkedserver (Transact-SQL)
sp_dropserver (Transact-SQL) sp_dropserver (Transact-SQL)
sp_helpserver & #40 ; Transact-SQL & #41 ; sp_helpserver (Transact-SQL)
Procédures stockées système (Transact-SQL) System Stored Procedures (Transact-SQL)
Procédures stockées de sécurité (Transact-SQL)Security Stored Procedures (Transact-SQL)