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.
Conventions 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 la valeur de cette option est définie à « true » (vrai), SQL Server 2005 considère que tous les caractères du serveur lié sont compatibles avec le serveur local quant au jeu de caractères et à l'ordre de classement (ou l'ordre de tri).
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
Indiqué à 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.
Notes
Un même serveur peut avoir plusieurs états.
Autorisations
Les autorisations ne sont pas vérifiées.
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é. |
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'
Voir aussi
Référence
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)