Compartilhar via


jobs.sp_purge_jobhistory (Trabalhos Elásticos do Azure) (Transact-SQL)

Aplica-se a: Banco de Dados SQL do Azure

Remove os registros de histórico de um trabalho no serviço de Trabalhos Elásticos do Azure para Banco de Dados SQL do Azure.

Esse procedimento armazenado compartilha o nome de sp_purge_jobhistory com um objeto semelhante no SQL Server para o serviço SQL Server Agent. Para obter informações sobre a versão do SQL Server Agent, consulte sp_purge_jobhistory.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@job_name [ = ] N'job_name'

O nome do trabalho para o qual os registros históricos serão excluídos. @job_name é nvarchar(128), com um padrão de NULL.

Tanto @job_id quanto @job_name devem ser especificados, mas ambos não podem ser especificados.

@job_id [ = ] job_id

O número de identificação do trabalho cujos registros serão excluídos. @job_id é uniqueidentifier, com um padrão de NULL.

Tanto @job_id quanto @job_name devem ser especificados, mas ambos não podem ser especificados.

@oldest_date [ = ] oldest_date

O registro mais antigo a ser retido no histórico. @oldest_date é datetime2, com um padrão de NULL. Quando @oldest_date é especificado, sp_purge_jobhistory remove apenas os registros mais antigos do que o valor especificado.

Todos os horários em trabalhos elásticos estão no fuso horário UTC.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

O histórico de trabalhos da Elastic é excluído automaticamente se tiver mais de 45 dias.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Somente membros do sysadmin podem usar esse procedimento armazenado para editar os atributos de trabalhos que pertencem a outros usuários.

Exemplos

R. Excluir o histórico de trabalhos antigo

O exemplo a seguir mostra como excluir o histórico de trabalhos antes de uma data específica.

Conecte-se ao job_database e execute o seguinte comando:

--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. Excluir um trabalho e todo o seu histórico de trabalhos

O exemplo a seguir mostra como excluir um trabalho usando jobs.sp_delete_job e todo o histórico de trabalhos relacionado.

Conecte-se ao job_database e execute o seguinte comando:

--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';