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

jobs.sp_purge_jobhistory (задания эластичных баз данных Azure) (Transact-SQL)

  • Статья

Применимо к: База данных SQL Azure

Удаляет записи журнала задания в службе заданий Эластичных баз данных Azure для База данных SQL Azure.

Эта хранимая процедура использует имя аналогичного sp_purge_jobhistory объекта в SQL Server для службы агент SQL Server. Сведения о версии агент SQL Server см. в sp_purge_jobhistory.

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

Синтаксис

[jobs].sp_purge_jobhistory [ @job_name = ] 'job_name'
      [ , [ @job_id = ] job_id ]
      [ , [ @oldest_date = ] oldest_date ]

Аргументы

[ @job_name = ] N'job_name'

Имя задания, для которого удаляются записи журнала. @job_name — nvarchar(128) с значением по умолчаниюNULL.

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

[ @job_id = ] job_id

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

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

[ @oldest_date = ] oldest_date

Самая ранняя запись журнала, которую необходимо сохранить. @oldest_date — datetime2 с значением по умолчаниюNULL. При указании sp_purge_jobhistory @oldest_date удаляет только записи, которые старше указанного значения.

Все время в эластичных заданиях находятся в часовом поясе UTC.

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

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

Замечания

Журнал эластичных заданий автоматически удаляется, если более 45 дней.

Разрешения

По умолчанию эту хранимую процедуру могут выполнять только члены предопределенной роли сервера sysadmin . Только члены sysadmin могут использовать эту хранимую процедуру для изменения атрибутов заданий, принадлежащих другим пользователям.

Примеры

А. Удаление старого журнала заданий

В следующем примере показано, как удалить журнал заданий до определенной даты.

Подключитесь к следующей команде job_database и выполните следующую команду:

--Connect to the job database specified when creating the job agent

-- Delete history of a specific job's executions older than the specified date
EXEC jobs.sp_purge_jobhistory
    @job_name = 'ResultPoolsJob',
    @oldest_date = '2016-07-01 00:00:00';
GO

B. Удаление задания и его журнала заданий

В следующем примере показано, как удалить задание с помощью jobs.sp_delete_job и всех связанных журналов заданий.

Подключитесь к следующей команде job_database и выполните следующую команду:

--Connect to the job database specified when creating the job agent

--Delete a job and all its history
EXEC jobs.sp_delete_job @job_name = 'ResultsPoolsJob';

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