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

sp_help_jobsteplog (Transact-SQL)

  • Статья

Область применения: SQL Server

Возвращает метаданные о конкретном журнале шагов задания агент SQL Server. sp_help_jobsteplog не возвращает фактический журнал.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_help_jobsteplog
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @step_id = ] step_id ]
    [ , [ @step_name = ] N'step_name' ]
[ ; ]

Аргументы

[ @job_id = ] 'job_id'

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

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

[ @job_name = ] N'job_name'

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

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

[ @step_id = ] step_id

Идентификатор этапа задания. Если не указан, включаются все этапы задания. @step_id имеет значение int с значением по умолчаниюNULL.

[ @step_name = ] N'step_name'

Имя шага задания. @step_name — sysname, значение по умолчанию NULL— sysname.

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

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

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

Имя столбца Тип данных Description
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 базе данных.

Разрешения

Вы можете предоставить EXECUTE разрешения для этой процедуры, но эти разрешения могут быть переопределены во время обновления SQL Server.

Другим пользователям необходимо предоставить одну из следующих агент 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

Связанный контент