sp_help_downloadlist(Transact-SQL)

  • 아티클

적용 대상:SQL Server

제공된 작업에 대한 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 기본값이 NULL인 uniqueidentifier입니다.

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

참고 항목

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

[ @operation = ] 'operation' 지정된 작업에 대한 유효한 작업입니다. 작업은 기본값이 NULL인 varchar(64)이며 이러한 값 중 하나일 수 있습니다.

값 설명
결함 마스터 SQLServerAgent 서비스에서 대상 서버의 결함을 요청하는 서버 작업입니다.
DELETE 전체 작업을 제거하는 작업 작업입니다.
INSERT 전체 작업을 추가하거나 기존 작업을 새로 고치는 작업의 수행입니다. 이 작업에는 해당하는 경우 모든 작업 단계 및 일정이 포함됩니다.
다시 등록 서버 작업이 대상 서버로 하여금 폴링 간격 및 다중 서버 도메인에 대한 표준 시간대를 포함하여 포함 정보를 다시 전달하도록 합니다. 대상 서버는 MSXOperator 세부 정보도 다시 로드합니다.
SET-POLL 대상 서버가 다중 서버 도메인을 폴링하는 간격(초)을 설정하는 서버 작업입니다. 지정된 경우 값은 필수 간격 값으로 해석되며 10에서 28,800까지의 값이 될 수 있습니다.
시작 작업 실행의 시작을 요청하는 작업 작업입니다.
중지 작업 실행 중지를 요청하는 작업 작업입니다.
동기화 시간 대상 서버가 시스템 클록을 다중 서버 도메인과 동기화하도록 하는 서버 작업입니다. 비용이 많이 드는 작업이므로 이 작업을 제한적으로 자주 수행합니다.
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서버인 경우 object_name서버 이름입니다.

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

[ @has_error = ] has_error 작업이 오류를 승인해야 하는지 여부입니다. has_error 오류가 승인되지 않음을 나타내는 NULL의 기본값과 함께 tinyint입니다. 1 은 모든 오류를 승인해야 임을 나타냅니다.

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

[ @date_posted = ] date_posted 지정된 날짜 및 시간 이후의 모든 항목을 결과 집합에 포함해야 하는 날짜 및 시간입니다. date_posted 날짜/시간이며 기본값은 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 명령(작업 개체에 대한 job_id 또는 서버 개체의 0x00) 또는 operation_code 관련된 데이터 값의 영향을 받는 개체의 ID입니다.
target_server nvarchar(30) 이 명령을 다운로드할 대상 서버입니다.
error_message nvarchar(1024) 이 명령을 처리하는 동안 문제가 발생한 경우 대상 서버의 오류 메시지(있는 경우)입니다.

참고: 오류 메시지는 대상 서버의 모든 추가 다운로드를 차단합니다.
date_posted datetime 지침이 테이블에 게시된 날짜입니다.
date_downloaded datetime 대상 서버에서 명령을 다운로드한 날짜입니다.
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)