sp_help_downloadlist (Transact-SQL)

Статья
08/22/2023

Применимо к: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 Идентификационный номер задания, для которого возвращаются сведения. job_id является уникальным идентификатором с значением NULL по умолчанию.

[ @job_name = ] 'job_name' Имя задания. job_name имеет имя sysname с значением NULL по умолчанию.

Заметка

Необходимо указать job_id или job_name, но их нельзя указать.

[ @operation = ] 'operation' Допустимая операция для указанного задания. операция — varchar (64) с значением NULL по умолчанию и может быть одним из этих значений.

значение	Description
ДЕФЕКТ	Операция сервера, которая запрашивает конечный сервер для дефекта из службы Master SQLServerAgent .
DELETE	Операция задания, удаляющая все задание.
INSERT	Операция задания, вставляющая все задание или обновляющая существующее задание. Эта операция включает все шаги и расписания задания, если возможно.
ПОВТОРНОЕ ПЕРЕЧИСЛЕНИЕ	Серверная операция, вызывающая повторную отсылку многосерверному домену целевым сервером его сведений о прикреплении, включая интервал опроса и часовой пояс. Целевой сервер также перезагрузит сведения о MSXOperator .
SET-POLL	Серверная операция, устанавливающая интервал в секундах для опроса многосерверного домена целевыми серверами. Если задано, значение интерпретируется как требуемое значение интервала и может быть значением от 10 до 28 800.
НАЧАТЬ	Операция задания, запрашивающая начало выполнения задания.
ОСТАНОВИТЬ	Операция задания, запрашивающая прекращение выполнения задания.
СИНХРОНИЗАЦИЯ	Серверная операция, вызывающая синхронизацию системных часов целевого сервера с многосерверным доменом. Это дорогостоящая операция, поэтому ее не стоит выполнять регулярно.
UPDATE	Операция задания, которая обновляет только сведения о системных заданиях для задания, а не шаги задания или расписания. Автоматически вызывается sp_update_job.

[ @object_type = ] 'object_type' Тип объекта для указанного задания. object_type — varchar(64) с значением NULL по умолчанию. object_type может быть заданием или СЕРВЕРом. Дополнительные сведения о допустимых значениях 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 Состояние задания. состояние tinyint с значением NULL по умолчанию.

[ @date_posted = ] date_posted Дата и время, для которого все записи, сделанные или после указанной даты и времени, должны быть включены в результирующий набор. date_posted — datetime с значением NULL по умолчанию.

Значения кода возврата

0 (успешно) или 1 (сбой)

Результирующие наборы

Имя столбца	Тип данных	Описание:
instance_id	int	Уникальный целочисленный идентификационный номер инструкции.
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.
target_server	nvarchar(30)	Целевой сервер, загружающий данную инструкцию.
error_message	nvarchar(1024)	Сообщение об ошибке (при наличии) от целевого сервера, если в процессе обработки этой инструкции возникает проблема. Примечание. Любое сообщение об ошибке блокирует все дальнейшие скачивание целевым сервером.
date_posted	datetime	Дата отправления инструкции в таблицу.
date_downloaded	datetime	Дата загрузки инструкции целевым сервером.
состояние	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)

Share via