• Статья

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

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

status

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'