sp_help_jobsteplog (Transact-SQL)
Возвращает метаданные об определенном журнале шагов заданий агента SQL Server. Процедура sp_help_jobsteplog не возвращает сам журнал.
Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии). |
.gif "Значок ссылки на раздел")
Cинтаксические обозначения в 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
Б.Возвращает сведения из журнала шага задания для определенного шага
В следующем примере выполняется возврат сведений журнала шагов задания для первого этапа задачи с именем Weekly Sales Data Backup.
USE msdb ;
GO
EXEC dbo.sp_help_jobsteplog
@job_name = N'Weekly Sales Data Backup',
@step_id = 1 ;
GO
См. также
Справочник
sp_delete_jobstep (Transact-SQL)
sp_help_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)