sp_helpserver (Transact-SQL)

Aplica-se a: SQL Server (todas as versões com suporte)

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.

Topic link iconConvenções de sintaxe do Transact-SQL

Sintaxe

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

Argumentos

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

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

Valor Descrição
compatível com ordenação 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 Editor remoto para este Distribuidor.
validação de esquema lenta Ignora a verificação de esquema de tabelas remotas no início da consulta.
pub Editor.
Rpc Habilita o RPC a partir do servidor especificado.
rpc out Habilita o RPC para o servidor especificado.
sub Assinante.
sistema Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.
usar ordenação remota Usa a ordenação 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 de NULL. Se show_topology não for igual a t ou for NULL, sp_helpserver retornará 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 do código de retorno

0 (êxito) ou 1 (falha).

Conjuntos 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

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';  

Consulte Também

Procedimentos armazenados do Mecanismo de Banco de Dados (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)
Procedimentos armazenados do sistema (Transact-SQL)