sp_help_jobsteplog (Transact-SQL)

  • Статья

Применимо к:SQL Server

Возвращает метаданные о конкретном журнале шагов задания агента 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 могут просматривать только метаданные журнала шагов задания для шагов задания, принадлежащих им.

Примеры

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

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

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

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

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

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

См. также

sp_add_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)
sp_help_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)
sp_delete_jobsteplog (Transact-SQL)
Хранимые процедуры агента SQL Server (Transact-SQL)