Бөлісу құралы:

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).

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

Синтаксис

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

Аргументы

@job_name

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

@job_id

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

@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

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

В следующем примере показано, как удалить задание с помощью 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';

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