sp_helpserver (Transact-SQL)

  • Artículo

Se aplica a: SQL Server

Presenta información acerca de un servidor remoto o de replicación concreto, o acerca de todos los servidores de los dos tipos. Proporciona la siguiente información sobre el servidor: nombre, nombre de red, estado de replicación, número de identificación y nombre de intercalación. Asimismo proporciona valores de tiempo de espera para conectarse a servidores vinculados o para realizar consultas en los mismos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_helpserver
    [ [ @server = ] N'server' ]
    [ , [ @optname = ] 'optname' ]
    [ , [ @show_topology = ] 'show_topology' ]
[ ; ]

Argumentos

[ @server = ] N'server'

Especifica el servidor sobre qué información se notifica. @server es sysname, con un valor predeterminado de NULL. Cuando no se especifica el servidor , devuelve información sobre todos los servidores de master.sys.servers.

[ @optname = ] 'optname'

Opción que describe el servidor. @optname es varchar(35) y debe ser uno de estos valores.

Valor Descripción
collation compatible Afecta a la ejecución de consultas distribuidas sobre servidores vinculados. Si esta opción se establece en TRUE,
data access Habilita y deshabilita un servidor vinculado para el acceso a consultas distribuidas.
dist Distribuidor.
dpub Publicador remoto de este distribuidor.
lazy schema validation Omite la comprobación del esquema de las tablas remotas al comienzo de la consulta.
pub Publisher.
rpc Habilita RPC desde el servidor especificado.
rpc out Habilita RPC en el servidor especificado.
sub Suscriptor.
system Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.
use remote collation Usa la intercalación de una columna remota en lugar de la intercalación del servidor local.

[ @show_topology = ] 'show_topology'

Relación del servidor especificado con otros servidores. @show_topology es varchar(1), con un valor predeterminado de NULL. Si @show_topology no es igual a t o es NULL, sp_helpserver devuelve columnas enumeradas en la sección Conjuntos de resultados. Si @show_topology es igual a t, además de las columnas enumeradas en el conjunto de resultados, sp_helpserver también devuelve topx e topy información.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Nombre de la columna Tipo de datos Descripción
name sysname Nombre de servidor.
network_name sysname El nombre de red del servidor.
status varchar(70) Estado del servidor.
id char(4) Número de identificación del servidor.
collation_name sysname Intercalación del servidor.
connect_timeout int Valor del tiempo de espera para conectar a un servidor vinculado.
query_timeout int Valor del tiempo de espera para consultas sobre un servidor vinculado.

Comentarios

Un servidor puede tener varios estados.

Permisos

No se comprueba ningún permiso.

Ejemplos

A Mostrar información sobre todos los servidores

En este ejemplo se presenta información acerca de todos los servidores mediante el uso de sp_helpserver sin parámetros.

USE master;
GO
EXEC sp_helpserver;

B. Mostrar información sobre un servidor específico

En este ejemplo se presenta toda la información acerca del servidor SEATTLE2.

USE master;
GO
EXEC sp_helpserver 'SEATTLE2';

Contenido relacionado