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


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'

Идентификационный номер задания, для которого возвращаются сведения. @job_id является уникальным идентификатором по умолчаниюNULL.

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

[ @job_name = ] N'job_name'

Имя задания. @job_name — sysname с значением по умолчаниюNULL.

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

[ = ] @operation 'operation'

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

значение Описание
DEFECT Операция сервера, которая запрашивает конечный сервер от службы master агент 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 — varchar(64) с значением по умолчаниюNULL. @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, которое указывает, что ошибки не должны быть подтверждены. 1 указывает, что все ошибки должны быть подтверждены.

[ @status = ] состояние

Состояние каждого задания. @status крошечный, по умолчанию NULL.

[ @date_posted = ] date_posted

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

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

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

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

Имя столбца Тип данных Description
instance_id int Уникальный целочисленный идентификационный номер инструкции.
source_server nvarchar(30) Имя сервера, с которого поступила инструкция.
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