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.
S'applique à : SQL Server (SQL Server 2008 via la version actuelle). |
.gif "Icône Lien de rubrique")
Conventions de la syntaxe 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, avec NULL comme valeur par défaut.[ @optname = ] 'option'
Option qui décrit le serveur. 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 de retour
0 (succès) ou 1 (échec).
Jeux de résultats
Nom de colonne |
Type de données |
Description |
|---|---|---|
name |
sysname |
Nom du serveur. |
network_name |
sysname |
Nom réseau du serveur. |
état |
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 spécifique
Cet exemple affiche toutes les informations sur le serveur SEATTLE2.
USE master;
GO
EXEC sp_helpserver 'SEATTLE2';
Voir aussi
Référence
Procédures stockées du moteur de base de données (Transact-SQL)
sp_adddistpublisher (Transact-SQL)
sp_addsubscriber (Transact-SQL)
sp_changesubscriber (Transact-SQL)
sp_dropsubscriber (Transact-SQL)
sp_helpdistributor (Transact-SQL)
sp_helpremotelogin (Transact-SQL)
sp_helpsubscriberinfo (Transact-SQL)