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
    정보를 나열할 프록시의 프록시 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)

    스냅숏

    복제 스냅숏 에이전트

    LogReader

    복제 로그 판독기 에이전트

    배포

    복제 배포 에이전트

    병합

    복제 병합 에이전트

    QueueReader

    복제 큐 판독기 에이전트

    ANALYSISQUERY

    Analysis Services 명령

    ANALYSISCOMMAND

    Analysis Services 쿼리

    Dts

    SSIS 패키지 실행

    PowerShell

    PowerShell 스크립트

  • [ **@name** = ] 'name'
    프록시를 나열할 SQL Server 로그인의 이름입니다. 이름은 nvarchar(256)이며 기본값은 NULL입니다. name을 지정하는 경우 subsystem_name도 지정해야 합니다.

반환 코드 값

0(성공) 또는 1(실패)

결과 집합

열 이름

데이터 형식

설명

proxy_id

int

프록시 ID입니다.

name

sysname

프록시 이름입니다.

credential_identity

sysname

프록시와 연관된 자격 증명의 Microsoft Windows 도메인 이름 및 사용자 이름입니다.

enabled

tinyint

이 프록시가 사용되는지 여부입니다. { 0 = 사용 안 함, 1 = 사용 }

description

nvarchar(1024)

이 프록시에 대한 설명입니다.

user_sid

varbinary(85)

이 프록시에 대한 Windows 사용자의 Windows 보안 ID입니다.

credential_id

int

이 프록시와 연관된 자격 증명의 식별자입니다.

credential_identity_exists

int

credential_identity가 있는지 여부입니다. { 0 = 없음, 1 = 있음 }

주의

매개 변수를 지정하지 않으면 sp_help_proxy는 인스턴스의 모든 프록시에 대한 정보를 나열합니다.

로그인이 지정된 하위 시스템에 사용할 수 있는 프록시를 확인하려면 name 및 subsystem_name을 지정하십시오. 이러한 인수를 지정하면 sp_help_proxy는 지정된 로그인이 액세스할 수 있고 지정된 하위 시스템에 사용할 수 있는 프록시를 나열합니다.

사용 권한

기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다. 다른 사용자는 msdb 데이터베이스의 SQLAgentOperatorRole 고정 데이터베이스 역할을 부여 받아야 합니다.

SQLAgentOperatorRole에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하십시오.

[!참고]

credential_identityuser_sid 열은 sysadmin의 멤버가 이 저장 프로시저를 실행하는 경우에만 결과 집합에 반환됩니다.

1.모든 프록시에 대한 정보 나열

다음 예에서는 인스턴스의 모든 프록시에 대한 정보를 나열합니다.

USE msdb ;
GO

EXEC dbo.sp_help_proxy ;
GO

2.특정 작업에 대한 정보 나열

다음 예에서는 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)