sp_help_proxy(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_identity 및 user_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