sp_helpserver (Transact-SQL)

  • Статья

Возвращает сведения об определенном удаленном сервере, сервере репликации либо обо всех серверах обоих типов. Выдает имя сервера, сетевое имя сервера, состояние репликации сервера, его идентификационный номер, а также имя параметров сортировки. Кроме того, возвращает значения тайм-аута для подключения к связанным серверам или выполнения запросов к ним.

Значок ссылки на раздел Синтаксические обозначения Transact-SQL

Синтаксис

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

Аргументы

  • [ @server = ] 'server'
    Сервер, о котором возвращаются сведения. Если аргумент server не задан, выдаются сведения обо всех серверах в базе данных master.sys.servers. Аргумент server имеет тип sysname и значение по умолчанию NULL.

  • [ @optname = ] 'option'
    Параметр, описывающий сервер. Параметр option имеет тип varchar(35) со значением по умолчанию NULL и должен иметь одно из этих значений.

    Значение

    Описание

    collation compatible

    Влияет на выполнение распределенных запросов на связанных серверах. Если значение этого параметра равно true.

    data access

    Разрешает и запрещает доступ распределенных запросов к связанному серверу.

    dist

    Распространитель.

    dpub

    Удаленный издатель для этого распространителя.

    lazy schema validation

    Пропускает проверку схемы удаленных таблиц в начале запроса.

    pub

    Издатель.

    rpc

    Включает RPC с определенного сервера.

    rpc out

    Включает RPC на определенный сервер.

    sub

    Подписчик.

    system

    Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.

    use remote collation

    Применение параметров сортировки удаленного столбца вместо параметров сортировки локального сервера.

  • [ @show_topology = ] 'show_topology'
    Связь указанного сервера с другими серверами. Аргумент show_topology имеет тип varchar(1) и значение по умолчанию NULL. Если значение аргумента show_topology не равно t или равно NULL, то процедура sp_helpserver возвращает столбцы, перечисленные в разделе «Результирующие наборы». Если значение аргумента show_topology равно t, то помимо столбцов, перечисленных в разделе «Результирующие наборы», хранимая процедура sp_helpserver возвращает данные topx и topy.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Имя столбца

Тип данных

Описание

name

sysname

Имя сервера.

network_name

sysname

Сетевое имя сервера.

состояние

varchar(70)

Состояние сервера.

id

char(4)

Идентификационный номер сервера.

collation_name

sysname

Параметры сортировки сервера.

connect_timeout

int

Значение времени ожидания для подключения к связанному серверу.

query_timeout

int

Значение времени ожидания для запросов к связанному серверу.

Замечания

У сервера может быть несколько состояний.

Разрешения

Разрешения не проверяются.

Примеры

А.Вывод сведений обо всех серверах

В следующем примере сведения обо всех серверах выводятся с помощью команды sp_helpserver без аргументов.

USE master;
GO
EXEC sp_helpserver

Б.Вывод сведений об определенном сервере

В следующем примере отображаются все сведения о сервере SEATTLE2.

USE master;
GO
EXEC sp_helpserver 'SEATTLE2'

См. также

Справочник

Хранимые процедуры ядра СУБД (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)

Системные хранимые процедуры (Transact-SQL)