sp_help_downloadlist (Transact-SQL)

Статья
03/07/2014

Перечисляет все строки в системной таблице sysdownloadlist для предоставленного задания или все строки, если задание не указано.

Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии).

Значок ссылки на раздел Cинтаксические обозначения в 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 имеет тип 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 до 28800.
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	Уникальный целочисленный идентификационный номер инструкции.
source_server	nvarchar(30)	Имя сервера, с которого поступила инструкция. В Microsoft SQL Server версии 7.0 это всегда имя компьютера главного сервера.
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	Дата загрузки инструкции целевым сервером.
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)

Поделиться через