• Artigo

sp_helpserver (Transact-SQL)

Relata informações sobre um determinado servidor de replicação ou remoto, ou sobre todos os servidores de ambos os tipos. Fornece o nome do servidor, o nome da rede do servidor, o status de replicação do servidor, o número de identificação do servidor e o nome de agrupamento. Também fornece valores de tempo limite para se conectar a servidores vinculados ou fazer consultas neles.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

  • [ @server = ] 'server'
    É o servidor sobre o qual as informações são relatadas. Quando server não é especificado, os relatórios sobre todos os servidores em master.sys.servers. server são sysname, com um padrão NULL.

  • [ @optname = ] 'option'
    É a opção que descreve o servidor. option é varchar(35), com um padrão NULL e deve ser um destes valores.

    Valor

    Descrição

    compatível com agrupamento

    Afeta a execução da consulta distribuída nos servidores vinculados. Se esta opção for definida como verdadeira,

    acesso a dados

    Habilita e desabilita um servidor vinculado para o acesso às consultas distribuídas.

    dist

    Distribuidor.

    dpub

    Publicador remoto para este Distribuidor.

    validação de esquema lenta

    Ignora a verificação de esquema de tabelas remotas no início da consulta.

    pub

    Publicador.

    rpc

    Habilita o RPC a partir do servidor especificado.

    rpc out

    Habilita o RPC para o servidor especificado.

    sub

    Assinante.

    system

    Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.

    usar agrupamento remoto

    Usa o agrupamento de uma coluna remota em vez do servidor local.

  • [ @show_topology = ] 'show_topology'
    É a relação do servidor especificado com outros servidores. show_topology é varchar(1), com um padrão NULL. Se show_topology não for igual a t ou for NULL, sp_helpserver retornará as colunas listadas na seção Conjuntos de Resultados. Se show_topology for igual a t, além das colunas listadas nos Conjuntos de Resultados, sp_helpserver também retornará informações topx e topy.

Valores de código de retorno

0 (êxito) ou 1 (falha).

Conjuntos de resultados

Nome da coluna

Tipo de dados

Descrição

name

sysname

Nome do servidor.

network_name

sysname

Nome da rede do servidor.

status

varchar(70)

Status do servidor.

id

char(4)

Número de identificação do servidor.

collation_name

sysname

Agrupamento do servidor.

connect_timeout

int

O valor do tempo limite para conexão com um servidor vinculado.

query_timeout

int

O valor do tempo limite para as consultas em servidor vinculado.

Comentários

Um servidor pode ter mais de um status.

Permissões

Nenhuma permissão é verificada.

Exemplos

A. Exibindo informações sobre todos os servidores

O exemplo a seguir exibe informações sobre todos os servidores usando sp_helpserver sem nenhum parâmetro.

USE master;
GO
EXEC sp_helpserver

B. Exibindo informações sobre um servidor específico

O exemplo a seguir exibe todas as informações sobre o servidor SEATTLE2.

USE master;
GO
EXEC sp_helpserver 'SEATTLE2'