Partager via

  • Article

sp_addserver (Transact-SQL)

Définit le nom de l'instance locale de SQL Server. Cette procédure stockée définit également un serveur distant.

[!REMARQUE]

La fonctionnalité de serveur distant sera supprimée dans la prochaine version de SQL Server. Pour définir des serveurs liés, utilisez sp_addlinkedserver à la place.

Icône Lien de rubriqueConventions de la syntaxe de 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, sans 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 si le serveur ajouté est un serveur local ou distant. @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. Nous vous recommandons de ne pas changer ce nom. 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 n'entre en vigueur qu'après arrêt et redémarrage du serveur. Un seul serveur local peut être défini sur chaque serveur.

  • [ @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.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

Pour exécuter une procédure stockée sur un serveur distant (appels de procédure distante) qui exécute une version antérieure de SQL Server, ajoutez le serveur distant à l'aide de sp_addserver. Pour exécuter une procédure stockée (ou une requête distribuée) sur un serveur qui exécute SQL Server version 7.0 ou ultérieure, utilisez sp_addlinkedserver pour ajouter le serveur.

Pour définir ou supprimer des options du serveur, utilisez sp_serveroption.

sp_addserver ne peut pas figurer dans une transaction définie par l'utilisateur.

Autorisations

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

Exemple

L'exemple suivant crée une entrée pour le serveur distant ACCOUNTS sur le serveur local.

sp_addserver 'ACCOUNTS';