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

  • Статья

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
    Идентификационный номер задания, для которого необходимо вернуть данные. Аргумент 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)

Имя сервера, с которого поступила инструкция. В MicrosoftSQL 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