sp_help_downloadlist(Transact-SQL)

적용 대상:SQL Server

제공된 작업에 대한 시스템 테이블의 sysdownloadlist 모든 행을 나열하거나 작업이 지정되지 않은 경우 모든 행을 나열합니다.

Transact-SQL 구문 표기 규칙

구문

sp_help_downloadlist
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @operation = ] 'operation' ]
    [ , [ @object_type = ] 'object_type' ]
    [ , [ @object_name = ] N'object_name' ]
    [ , [ @target_server = ] N'target_server' ]
    [ , [ @has_error = ] has_error ]
    [ , [ @status = ] status ]
    [ , [ @date_posted = ] date_posted ]
[ ; ]

인수

[ @job_id = ] 'job_id'

정보를 반환할 작업 ID 번호입니다. @job_id 기본값NULL인 uniqueidentifier입니다.

@job_id 또는 @job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.

[ @job_name = ] N'job_name'

작업의 이름입니다. @job_name sysname이며 기본값은 .입니다NULL.

@job_id 또는 @job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.

[ @operation = ] 'operation'

지정된 작업에 대한 유효한 작업입니다. @operation varchar(64)이며 이러한 값 중 하나일 수 있습니다.

값	설명
DEFECT	마스터 SQL Server 에이전트 서비스에서 대상 서버의 결함을 요청하는 서버 작업입니다.
DELETE	전체 작업을 제거하는 작업 작업입니다.
INSERT	전체 작업을 추가하거나 기존 작업을 새로 고치는 작업의 수행입니다. 이 작업에는 해당하는 경우 모든 작업 단계 및 일정이 포함됩니다.
RE-ENLIST	서버 작업이 대상 서버로 하여금 폴링 간격 및 다중 서버 도메인에 대한 표준 시간대를 포함하여 포함 정보를 다시 전달하도록 합니다. 대상 서버도 세부 정보를 다시 로드합니다 MSXOperator .
SET-POLL	대상 서버가 다중 서버를 폴링할 간격(초)을 설정하는 서버 작업은 기본. 지정된 경우 @value 필수 간격 값으로 해석되며 10에서 28,800까지의 값이 될 수 있습니다.
START	작업 실행의 시작을 요청하는 작업 작업입니다.
STOP	작업 실행 중지를 요청하는 작업 작업입니다.
SYNC-TIME	대상 서버가 시스템 클록을 다중 서버와 동기화하도록 하는 서버 작업은 기본. 비용이 많이 드는 작업이므로 이 작업을 제한적으로 자주 수행합니다.
UPDATE	작업 단계 또는 일정이 아닌 작업에 대한 정보만 sysjobs 업데이트하는 작업 작업입니다. 에 의해 sp_update_job자동으로 호출됩니다.

[ @object_type = ] 'object_type'

지정된 작업에 대한 개체의 형식입니다. @object_type 기본값NULL인 varchar(64)입니다. @object_type 중 하나 JOB 일 수 있습니다.SERVER 유효한 @object_type 값에 대한 자세한 내용은 sp_add_category 참조하세요.

[ @object_name = ] N'object_name'

개체 이름입니다. @object_name sysname이며 기본값은 .입니다NULL. @object_type JOB경우 @object_name 작업 이름입니다. @object_type SERVER경우 @object_name 서버 이름입니다.

[ @target_server = ] N'target_server'

대상 서버의 이름입니다. @target_server sysname이며 기본값은 .입니다NULL.

[ @has_error = ] has_error

작업에서 오류를 승인해야 하는지 여부를 지정합니다. @has_error 오류가 승인되지 않음을 나타내는 기본값NULL인 tinyint입니다. 1 는 모든 오류를 승인해야 했음을 나타냅니다.

[ @status = ] 상태

작업에 대한 상태. @상태 기본값NULL인 tinyint입니다.

[ @date_posted = ] date_posted

지정된 날짜 및 시간 이후의 모든 항목을 결과 집합에 포함해야 하는 날짜 및 시간입니다. @date_posted datetime이며 기본값은 .입니다NULL.

반환 코드 값

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

결과 집합

열 이름	데이터 형식	설명
instance_id	int	명령의 고유한 정수 ID입니다.
source_server	nvarchar(30)	명령이 제공된 서버의 컴퓨터 이름입니다.
operation_code	nvarchar(4000)	명령에 대한 작업 코드입니다.
object_name	sysname	명령의 영향을 받는 개체입니다.
object_id	uniqueidentifier	명령(job_id 작업 개체 또는 서버 개체의 경우) 또는 0x00 특정 데이터 값의 영향을 받는 개체의 operation_codeID 번호입니다.
target_server	nvarchar(30)	이 명령을 다운로드해야 하는 대상 서버입니다.
error_message	nvarchar(1024)	이 명령을 처리하는 동안 문제가 발생한 경우 대상 서버의 오류 메시지(있는 경우)입니다. 참고: 오류 메시지는 대상 서버의 모든 추가 다운로드를 차단합니다.
date_posted	날짜/시간	지침이 테이블에 게시된 날짜입니다.
date_downloaded	날짜/시간	대상 서버에서 명령을 다운로드한 날짜입니다.
status	tinyint	작업의 상태입니다. 0 = 아직 다운로드되지 않음 1 = 성공적으로 다운로드되었습니다.

사용 권한

이 절차를 실행할 수 있는 권한은 기본적으로 sysadmin 고정 서버 역할의 멤버에게 부여됩니다.

예제

다음 예제에서는 작업에 대한 행을 sysdownloadlist 나열합니다 NightlyBackups .

USE msdb;
GO

EXEC dbo.sp_help_downloadlist
    @job_name = N'NightlyBackups',
    @operation = N'UPDATE',
    @object_type = N'JOB',
    @object_name = N'NightlyBackups',
    @target_server = N'SEATTLE2',
    @has_error = 1,
    @status = NULL,
    @date_posted = NULL;
GO

관련 콘텐츠

• 시스템 저장 프로시저(Transact-SQL)