sp_help_proxy (Transact-SQL)

Выводит сведения об одной и нескольких учетных записях-посредниках.

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

Синтаксис

sp_help_proxy 
    [ @proxy_id = ] id,
    [ @proxy_name = ] 'proxy_name' ,
    [ @subsystem_name = ] 'subsystem_name' ,
    [ @name = ] 'name'

Аргументы

  • [ @proxy_id = ] id
    Идентификационный номер учетной записи-посредника, для которой необходимо вывести список сведений. Аргумент proxy_id имеет тип int и значение по умолчанию NULL. Необходимо указать либо аргумент id, либо аргумент proxy_name.

  • [ @proxy_name = ] 'proxy_name'
    Имя учетной записи-посредника, для которой необходимо вывести список сведений. Аргумент proxy_name имеет тип sysname и значение по умолчанию NULL. Необходимо указать либо аргумент id, либо аргумент proxy_name.

  • [ @subsystem_name = ] 'subsystem_name'
    Имя подсистемы, для которой будут выводиться учетные записи-посредники. Аргумент subsystem_name имеет тип sysname и значение по умолчанию NULL. Когда указан аргумент subsystem_name, необходимо указать и аргумент name.

    В следующей таблице показаны значения для каждой подсистемы.

    Значение

    Описание

    ActiveScripting

    Сценарий ActiveX

    CmdExec

    Операционная система (CmdExec)

    Snapshot

    Агент моментальных снимков репликации

    LogReader

    Агент чтения журнала репликации

    Distribution

    Агент распространения репликации

    Merge

    Агент слияния репликации

    QueueReader

    Агент чтения очереди репликации

    ANALYSISQUERY

    Команда служб Analysis Services

    ANALYSISCOMMAND

    Запрос служб Analysis Services

    Dts

    Выполнение пакетов служб SSIS

    PowerShell

    Сценарий PowerShell

  • [ @name = ] 'name'
    Имя входа SQL Server, для которого должны быть перечислены учетные записи-посредники. Аргумент name имеет тип nvarchar(256) и значение по умолчанию NULL. Когда указан аргумент name, необходимо указать и аргумент subsystem_name.

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

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

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

Имя столбца

Тип данных

Описание

proxy_id

int

Идентификационный номер учетной записи-посредника.

name

sysname

Имя учетной записи-посредника.

credential_identity

sysname

Имя домена и имя пользователя Microsoft Windows для учетных данных, относящихся к учетной записи-посреднику.

enabled

tinyint

Указывает, включена ли учетная запись-посредник. { 0 = Отключена, 1 = Включена }

description

nvarchar(1024)

Описание этой учетной записи-посредника.

user_sid

varbinary(85)

Идентификатор безопасности Windows для пользователя Windows, соответствующего этой учетной записи-посреднику.

credential_id

int

Идентификатор учетных данных, связанных с учетной записью-посредником.

credential_identity_exists

int

Указывает, существует ли столбец credential_identity. { 0 = Не существует, 1 = Существует }

Замечания

Если аргументы не указаны, процедура sp_help_proxy выводит сведения обо всех учетных записях-посредниках в данном экземпляре.

Чтобы определить, какими учетными записями-посредниками для данной подсистемы может воспользоваться определенное имя входа, укажите аргументы name и subsystem_name. Если эти аргументы определены, хранимая процедура sp_help_proxy перечислит учетные записи-посредники, к которым указанное имя входа имеет доступ и которые могут использоваться при работе с указанной подсистемой.

Разрешения

По умолчанию выполнять эту хранимую процедуру могут члены предопределенной роли сервера sysadmin. Другим пользователям должна быть предоставлена предопределенная роль базы данных SQLAgentOperatorRole в базе данных msdb.

Более подробные сведения о роли SQLAgentOperatorRole см. в разделе Предопределенные роли базы данных агента SQL Server.

ПримечаниеПримечание

Столбцы credential_identity и user_sid возвращаются в результирующем наборе лишь тогда, когда хранимая процедура выполняется членом роли sysadmin.

Примеры

А. Перечисление сведений обо всех учетных записях-посредниках

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

USE msdb ;
GO

EXEC dbo.sp_help_proxy ;
GO

Б. Перечисление сведений для определенной учетной записи-посредника

В следующем примере выводятся сведения, относящиеся к учетной записи-посреднику с именем Catalog application proxy.

USE msdb ;
GO

EXEC dbo.sp_help_proxy
    @proxy_name = N'Catalog application proxy' ;
GO