sp_helpserver (Transact-SQL)

  • Article

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 = ] N'server' ]
    [ , [ @optname = ] 'optname' ]
    [ , [ @show_topology = ] 'show_topology' ]
[ ; ]

Arguments

[ @server = ] N’server'

Spécifie le serveur sur lequel les informations sont signalées. @server est sysname, avec la valeur par défaut NULL. Quand le serveur n’est pas spécifié, retourne des informations sur tous les serveurs dans master.sys.servers.

[ @optname = ] 'optname'

Option décrivant le serveur. @optname est varchar(35) et doit être l’une de ces valeurs.

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 Publisher.
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 Utilise le classement d’une colonne distante au lieu du classement du serveur local.

[ @show_topology = ] 'show_topology'

Relation du serveur spécifié à d’autres serveurs. @show_topology est varchar(1), avec la valeur par défaut NULL. Si @show_topology n’est pas égal ou t non NULL, sp_helpserver retourne des 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 le jeu de résultats, sp_helpserver retourne topx également et topy des informations.

Valeurs des codes de retour

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

Jeu 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

Aucune autorisation n’est vérifiée.

Exemples

R. Afficher des 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. Afficher des informations sur un serveur spécifique

Cet exemple affiche toutes les informations sur le serveur SEATTLE2.

USE master;
GO
EXEC sp_helpserver 'SEATTLE2';

Contenu connexe