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


sp_help_jobsteplog (Transact-SQL)

Возвращает метаданные об определенном журнале шагов заданий агента SQL Server. Процедура sp_help_jobsteplog не возвращает действительный журнал.

Значок ссылки на разделСоглашения о синтаксическом обозначении в Transact-SQL

Синтаксис

sp_help_jobsteplog { [ @job_id = ] 'job_id' | [ @job_name = ] 'job_name' }
     [ , [ @step_id = ] step_id ]
     [ , [ @step_name = ] 'step_name' ]

Аргументы

  • [ @job_id =] 'job_id'
    Идентификационный номер задачи, для которого возвращаются сведения из журнала шагов задания. Аргумент job_id имеет тип int и значение по умолчанию NULL.

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

    ПримечаниеПримечание

    Должен быть указан один из аргументов job_id или job_name, но оба этих аргумента указаны быть не могут.

  • [ @step_id =] step_id
    Идентификационный номер шага задачи. Если параметр не указан, то включаются все шаги задачи. Аргумент step_id имеет тип int и значение по умолчанию NULL.

  • [ @step_name =] 'step_name'
    Имя шага задачи. Аргумент step_name имеет тип sysname и значение по умолчанию NULL.

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

0 (успешное завершение) или 1 (неуспешное завершение)

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

Имя столбца

Тип данных

Описание

job_id

uniqueidentifier

Уникальный идентификатор задания.

job_name

sysname

Имя задания.

step_id

int

Идентификатор для этапа задачи. Например, если этап является в задаче первым, то его аргумент step_id равен 1.

step_name

sysname

Имя шага задачи.

step_uid

uniqueidentifier

Уникальный идентификатор этапа (задается системой) задачи.

date_created

datetime

Дата создания этапа.

date_modified

datetime

Дата последнего изменения этапа.

log_size

float

Размер журнала шага задания в мегабайтах (МБ).

log

nvarchar(max)

Вывод журнала шага задания.

Замечания

Процедура sp_help_jobsteplog находится в базе данных msdb.

Разрешения

По умолчанию эту хранимую процедуру могут выполнять члены предопределенной роли сервера sysadmin. Другим пользователям должна быть предоставлена одна из следующих предопределенных ролей базы данных агента SQL Server в базе данных msdb:

  • SQLAgentUserRole;

  • SQLAgentReaderRole;

  • SQLAgentOperatorRole.

Подробные сведения о разрешениях для этих ролей см. в разделе Предопределенные роли базы данных агента SQL Server.

Члены роли SQLAgentUserRole могут просматривать метаданные из журнала шага задания только для собственных этапов задач.

Примеры

A. Возвращает сведения из журнала шагов задания для всех этапов в указанной задаче

В следующем примере выполняется возврат сведений из журнала шагов задания с именем Weekly Sales Data Backup.

USE msdb ;
GO

EXEC dbo.sp_help_jobsteplog
    @job_name = N'Weekly Sales Data Backup' ;
GO

Б. Возвращает сведения из журнала шага задания для определенного этапа

В следующем примере выполняется возврат сведений журнала шагов задания для первого этапа задачи с именем Weekly Sales Data Backup.

USE msdb ;
GO

EXEC dbo.sp_help_jobsteplog
    @job_name = N'Weekly Sales Data Backup',
    @step_id = 1 ;
GO