다음을 통해 공유


sp_help_downloadlist(Transact-SQL)

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

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

sp_help_downloadlist { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } 
     [ , [ @operation = ] 'operation' ] 
     [ , [ @object_type = ] 'object_type' ] 
     [ , [ @object_name = ] 'object_name' ] 
     [ , [ @target_server = ] 'target_server' ] 
     [ , [ @has_error = ] has_error ] 
     [ , [ @status = ] status ] 
     [ , [ @date_posted = ] date_posted ]

인수

  • [ @job_id= ] job_id
    정보를 반환할 작업의 ID입니다. job_id는 uniqueidentifier이며 기본값은 NULL입니다.

  • [ @job_name= ] 'job_name'
    작업 이름입니다. job_name은 sysname이며 기본값은 NULL입니다.

    [!참고]

    job_id 또는 job_name 중 하나를 지정해야 하며 둘 다를 지정할 수는 없습니다.

  • [ @operation= ] 'operation'
    지정된 작업에 유효한 작업입니다. operation은 varchar(64)이며 기본값은 NULL이고 다음 값 중 하나를 사용할 수 있습니다.

    설명

    DEFECT

    마스터 SQLServerAgent 서비스에서 제거할 대상 서버를 요청하는 서버 작업입니다.

    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은 varchar(64)이며 기본값은 NULL입니다. object_type은 JOB이나 SERVER일 수 있습니다. 유효한 object_type 값에 대한 자세한 내용은 sp_add_category(Transact-SQL)를 참조하십시오.

  • [ @object_name= ] 'object_name'
    개체 이름입니다. object_name은 sysname이며 기본값은 NULL입니다. object_type이 JOB인 경우 object_name은 작업 이름이 됩니다. object_type이 SERVER인 경우 object_name은 서버 이름이 됩니다.

  • [ @target_server= ] 'target_server'
    대상 서버의 이름입니다. target_server는 nvarchar(128)이며 기본값은 NULL입니다.

  • [ @has_error= ] has_error
    작업이 오류를 승인해야 하는지 여부입니다. has_error는 tinyint이며 기본값은 NULL로 오류를 승인하지 않아도 된다는 의미입니다. 1은 모든 오류를 승인해야 한다는 의미입니다.

  • [ @status= ] status
    작업의 상태입니다. status는 tinyint이며 기본값은 NULL입니다.

  • [ @date_posted= ] date_posted
    모든 항목이 생성된 날짜와 시간 또는 결과 집합에 포함되어야 하는 이후에 지정된 날짜와 시간입니다. date_posted는 datetime이며 기본값은 NULL입니다.

반환 코드 값

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

결과 집합

열 이름

데이터 형식

설명

instance_id

int

명령의 고유한 정수 ID입니다.

source_server

nvarchar(30)

명령을 발생시킨 서버의 컴퓨터 이름입니다. Microsoft SQL Server 버전 7.0에서는 항상 마스터(MSX) 서버의 컴퓨터 이름입니다.

operation_code

nvarchar(4000)

명령의 작업 코드입니다.

object_name

sysname

명령이 적용되는 개체입니다.

object_id

uniqueidentifier

명령의 영향을 받는 개체의 ID(작업 개체의 경우 job_id, 서버 개체의 경우 0x00) 또는 operation_code에 대한 데이터 값입니다.

target_server

nvarchar(30)

해당 명령이 다운로드될 대상 서버입니다.

error_message

nvarchar(1024)

명령을 처리하는 동안 문제가 발생하는 경우 대상 서버에서 발행되는 오류 메시지입니다.

참고참고
오류 메시지가 발생하면 대상 서버가 더 이상 다운로드를 못하도록 모든 다운로드 작업을 차단합니다.

date_posted

datetime

명령이 테이블에 게시된 날짜입니다.

date_downloaded

datetime

대상 서버가 명령을 다운로드한 날짜입니다.

status

tinyint

작업의 상태입니다.

0 = 아직 다운로드되지 않았습니다.

1 = 성공적으로 다운로드되었습니다.

사용 권한

이 프로시저를 실행할 수 있는 권한은 기본적으로 sysadmin 고정 서버 역할의 멤버로 설정됩니다.

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

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