• Article

sp_helpserver (Transact-SQL)

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.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @server =] 'server'
    Serveur sur lequel sont fournies les informations. Lorsque l'argument server n'est pas spécifié, des informations sont fournies sur tous les serveurs dans master.sys.servers. server est de type sysname et sa valeur par défaut est NULL.

  • [ @optname = ] 'option'
    Option qui décrit le serveur. L'argument option est de type varchar(35), avec NULL comme valeur par défaut. Il peut prendre une des valeurs ci-dessous.

    Valeur

    Description

    collation compatible

    Affecte l'exécution des requêtes distribuées sur les serveurs liés. Si cette option a la valeur true,

    data access

    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

    Serveur de publication.

    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é.

    system

    Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

    use remote collation

    Le classement d'une colonne distante est utilisé à la place de celui du serveur local.

  • [ @show_topology = ] 'show_topology'
    Relation entre le serveur spécifié et d'autres serveurs. show_topology est de type varchar(1), avec NULL comme valeur par défaut. Si la valeur de show_topology est différente de t ou est NULL, sp_helpserver renvoie les colonnes figurant dans la section Ensembles de résultats. Si show_topology est égal à t, des informations topx et topy sont renvoyées par sp_helpserver en plus des colonnes figurant dans la section Ensembles de résultats.

Valeurs des codes renvoyés

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

Ensembles 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.

status

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é.

Notes

Un même serveur peut avoir plusieurs états.

Autorisations

Les autorisations ne sont pas vérifiées.

Exemples

A. 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 particulier

Cet exemple affiche toutes les informations sur le serveur SEATTLE2.

USE master;
GO
EXEC sp_helpserver 'SEATTLE2'