Compartilhar via

jobs.sp_purge_jobhistory (Azure Elastic Jobs) (Transact-SQL)

  • Artigo

Aplica-se a:Banco de Dados SQL do Azure

Remove os registros de histórico de um trabalho no serviço Azure Elastic Jobs para o 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 (Transact-SQL).

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

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. Devem ser especificados job_id ou job_name , mas ambos não podem ser especificados.

@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. Devem ser especificados job_id ou job_name , mas ambos não podem ser especificados.

@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 que são 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 (êxito) ou 1 (falha)

Comentários

O histórico de trabalho elástico é 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 os membros da função sysadmin podem usar esse procedimento armazenado para editar os atributos dos trabalhos pertencentes a outros usuários.

Exemplos

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

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

Conteúdo relacionado