Compartilhar via

sp_helpserver (Transact-SQL)

  • Artigo

Aplica-se: SQL Server

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 ordenação. Também fornece valores de tempo limite para se conectar a servidores vinculados ou fazer consultas neles.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@server [ = ] N'servidor'

Especifica o servidor sobre o qual as informações são relatadas. @server é sysname, com um padrão de NULL. Quando o servidor não é especificado, retorna informações sobre todos os servidores no master.sys.servers.

@optname [ = ] 'optname'

A opção que descreve o servidor. @optname é varchar(35) e deve ser um desses valores.

Valor Descrição
collation compatible Afeta a execução da consulta distribuída nos servidores vinculados. Se esta opção for definida como verdadeira,
data access Habilita e desativa um servidor vinculado para acesso a consultas distribuídas.
dist Distribuidor.
dpub Editor remoto para este Distribuidor.
lazy schema validation 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 a RPC para o servidor especificado.
sub Subscritor.
system Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.
use remote collation Usa a ordenação de uma coluna remota em vez da ordenação do servidor local.

@show_topology [ = ] 'show_topology'

A relação do servidor especificado com outros servidores. @show_topology é varchar(1), com um padrão de 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 no conjunto de resultados, sp_helpserver também retorna topx e topy informações.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nome da coluna Tipo de dados Descrição
name sysname Nome de 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 Ordenação 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

R. Exibir 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. Exibir 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';

Conteúdo relacionado