sp_helpserver (Transact-SQL)

S’applique à :SQL Server

Fournit des informations sur un serveur distant, sur un serveur de réplication particulier ou sur tous les serveurs des deux types. Fournit le nom du serveur, le nom réseau du serveur, l'état de réplication du serveur, le numéro d'identification du serveur et le nom du classement. Fournit également les valeurs des délais d'expiration pour les connexions ou les requêtes des serveurs liés.

Conventions de la syntaxe Transact-SQL

Syntaxe

  
sp_helpserver [ [ @server = ] 'server' ]   
  [ , [ @optname = ] 'option' ]   
  [ , [ @show_topology = ] 'show_topology' ]  

Arguments

[ @server = ] 'server' Serveur sur lequel les informations sont signalées. Lorsque le serveur n’est pas spécifié, signale tous les serveurs dansmaster.sys.servers. le serveur est sysname, avec la valeur par défaut NULL.

[ @optname = ] 'option' Option décrivant le serveur. l’option est varchar(35), avec la valeur par défaut NULL, et doit être l’une de ces valeurs.

Valeur Description
Compatibilité de classement Affecte l'exécution des requêtes distribuées sur les serveurs liés. Si cette option a la valeur true,
accès aux données Active ou désactive un serveur lié pour l'accès des requêtes distribuées.
dist Serveur de distribution.
dpub Serveur de publication distant de ce serveur de distribution.
lazy schema validation La vérification du schéma des tables distantes est ignorée au début de la requête.
Pub Éditeur.
rpc Active l'appel de procédure à distance (RPC) à partir du serveur spécifié.
rpc out Active l'appel de procédure à distance (RPC) à destination du serveur spécifié.
sub Abonné.
système Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
utiliser le classement distant Le classement d'une colonne distante est utilisé à la place de celui du serveur local.

[ @show_topology = ] 'show_topology' Relation du serveur spécifié avec d’autres serveurs. show_topology est varchar(1), avec la valeur par défaut NULL. Si show_topology n’est pas égal à t ou a la valeur NULL, sp_helpserver retourne les colonnes répertoriées dans la section Jeux de résultats. Si show_topology est égal à t, en plus des colonnes répertoriées dans les jeux de résultats, sp_helpserver renvoie également des informations topx et topy .

Codet de retour

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

Jeux de résultats

Nom de la colonne Type de données Description
name sysname Nom du serveur.
network_name sysname Nom réseau du serveur.
statut varchar(70) État du serveur.
id char(4) Numéro d'identification du serveur.
collation_name sysname Classement du serveur.
connect_timeout int Valeur du délai d'expiration de la connexion au serveur lié.
query_timeout int Valeur du délai d'expiration des requêtes sur le serveur lié.

Remarques

Un même serveur peut avoir plusieurs états.

Autorisations

Aucune autorisation n’est vérifiée.

Exemples

R. Affichage d’informations sur tous les serveurs

L'exemple suivant affiche des informations sur tous les serveurs en utilisant la procédure sp_helpserver sans paramètre.

USE master;  
GO  
EXEC sp_helpserver;  

B. Affichage d'informations sur un serveur spécifique

Cet exemple affiche toutes les informations sur le serveur SEATTLE2.

USE master;  
GO  
EXEC sp_helpserver 'SEATTLE2';  

Voir aussi

Procédures stockées du moteur de base de données (Transact-SQL)
sp_adddistpublisher (Transact-SQL)
sp_addserver (Transact-SQL)
sp_addsubscriber (Transact-SQL)
sp_changesubscriber (Transact-SQL)
sp_dropserver (Transact-SQL)
sp_dropsubscriber (Transact-SQL)
sp_helpdistributor (Transact-SQL)
sp_helpremotelogin (Transact-SQL)
sp_helpsubscriberinfo (Transact-SQL)
sp_serveroption (Transact-SQL)
Procédures stockées système (Transact-SQL)