Поделиться через


sp_help_proxy (Transact-SQL)

Область применения: SQL Server

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_help_proxy
    [ [ @proxy_id = ] proxy_id ]
    [ , [ @proxy_name = ] N'proxy_name' ]
    [ , [ @subsystem_name = ] N'subsystem_name' ]
    [ , [ @name = ] N'name' ]
[ ; ]

Аргументы

[ @proxy_id = ] proxy_id

Идентификационный номер учетной записи-посредника, для которой необходимо вывести список сведений. @proxy_id имеет значение int с значением по умолчаниюNULL. Можно указать @proxy_id или @proxy_name.

[ @proxy_name = ] N'proxy_name'

Имя учетной записи-посредника, для которой необходимо вывести список сведений. @proxy_name — sysname с значением по умолчаниюNULL. Можно указать @proxy_id или @proxy_name.

[ @subsystem_name = ] N'subsystem_name'

Имя подсистемы, для которой будут выводиться учетные записи-посредники. @subsystem_name имеет имя sysname с значением по умолчаниюNULL. При указании @subsystem_name также необходимо указать @name.

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

значение Описание
ActiveScripting Скрипт ActiveX
CmdExec Операционная система (CmdExec)
Snapshot Агент моментальных снимков репликации
LogReader Replication Log Reader Agent
Distribution Агент распространения репликации
Merge Replication Merge Agent
QueueReader Replication Queue Reader Agent
ANALYSISQUERY Команда Analysis Services
ANALYSISCOMMAND Запрос служб Analysis Services
Dts Выполнение пакетов служб SSIS
PowerShell Сценарий PowerShell

[ @name = ] N'name'

Имя имени входа SQL Server для списка прокси-серверов. @name — nvarchar(256) с значением по умолчаниюNULL. При указании @name необходимо также указать @subsystem_name.

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

0 (успешно) или 1 (сбой).

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

Имя столбца Тип данных Description
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 этих аргументов перечисляет прокси-серверы, к которым может обращаться указанный вход, и которые могут использоваться для указанной подсистемы.

Разрешения

Вы можете предоставить EXECUTE разрешения для этой процедуры, но эти разрешения могут быть переопределены во время обновления SQL Server.

Другим пользователям необходимо предоставить одну из следующих агент SQL Server предопределенных ролей базы данных в msdb базе данных:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Дополнительные сведения о разрешениях этих ролей см. в разделе Предопределенные роли базы данных агента SQL Server.

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

Примеры

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

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

USE msdb;
GO

EXEC dbo.sp_help_proxy;
GO

B. Перечисление сведений для конкретного прокси-сервера

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

USE msdb;
GO

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