sp_help_proxy (Transact-SQL)

Статья
08/21/2023

Применимо к:SQL Server

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

Синтаксис

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

Аргументы

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

[ @proxy_name = ] 'proxy_name' Имя прокси-сервера для перечисления сведений. Proxy_name имеет имя sysname с значением NULL по умолчанию. Можно указать идентификатор или proxy_name.

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

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

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

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

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

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

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

Имя столбца	Тип данных	Описание:
proxy_id	int	Идентификационный номер учетной записи-посредника.
name	sysname	Имя учетной записи-посредника.
credential_identity	sysname	Имя домена и имя пользователя Microsoft Windows для учетных данных, относящихся к учетной записи-посреднику.
enabled	tinyint	Указывает, включена ли учетная запись-посредник. { 0 = не включен, 1 = включено }
описание	nvarchar(1024)	Описание этой учетной записи-посредника.
user_sid	varbinary(85)	Идентификатор безопасности Windows для пользователя Windows, соответствующего этой учетной записи-посреднику.
credential_id	int	Идентификатор учетных данных, связанных с учетной записью-посредником.
credential_identity_exists	int	Указывает, существует ли столбец credential_identity. { 0 = не существует, 1 = существует }

Замечания

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

Чтобы определить, какие прокси-серверы могут использовать для данной подсистемы, укажите имя и 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

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

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

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

См. также

Хранимые процедуры агента SQL Server (Transact-SQL)
Хранимая процедура sp_add_proxy (Transact-SQL)
sp_delete_proxy (Transact-SQL)