sp_purge_jobhistory (języka Transact-SQL)

Argumenty

• [ @job_name= ] 'job_name'
  The name of the job for which to delete the history records.job_nameis sysname, with a default of NULL.Albo job_id lub job_name musi być określona, ale nie może być jednocześnie określone.

  Uwaga

  Członkowie sysadmin Rola serwera lub członkami SQLAgentOperatorRole stała rola bazy danych może być wykonywany sp_purge_jobhistory bez określenia job_name lub job_id. Kiedy sysadmin użytkowników nie zostaną określone te argumenty, historia zatrudnienia dla wszystkich zadań lokalnych i wieloserwerowych jest usuwany w ramach czas określony przez oldest_date. Kiedy SQLAgentOperatorRole użytkowników nie zostaną określone te argumenty zadanie Historia dla wszystkich lokalnych zadanie s zostanie usunięta w czasie określonym przez oldest_date.

• [ @job_id= ] job_id
  The job identification number of the job for the records to be deleted.job_idis uniqueidentifier, with a default of NULL.Albo job_id lub job_name musi być określona, ale nie może być jednocześnie określone. Patrz Uwaga w opisie @ job_name Aby uzyskać informacje na temat, sysadmin or SQLAgentOperatorRole użytkownicy mogą używać tego argumentu.

• [ @ oldest_date = ] oldest_date
  The oldest record to retain in the history.oldest_date is datetime, with a default of NULL.Kiedy oldest_date jest określony, sp_purge_jobhistory usuwa tylko rekordy, które są starsze niż określona wartość.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Zestawy wyników

None

Remarks

Kiedy sp_purge_jobhistory zakończy się pomyślnie, zwracany jest komunikat.

Uprawnienia

Domyślnie tylko członkowie sysadmin stała rola serwera or the SQLAgentOperatorRole stała rola bazy danych można wykonać tej procedura przechowywana.Członkowie sysadmin może przeczyścić zadanie historia dla wszystkich zadań wieloserwerowych i lokalne.Członkowie SQLAgentOperatorRole może przeczyścić zadanie historia dla wszystkich tylko lokalnych zadanie.

Innym użytkownikom, łącznie z członkami SQLAgentUserRole a członkówSQLAgentReaderRole, należy jawnie zagwarantowane uprawnienie wykonać sp_purge_jobhistory.Po są przyznane uprawnienie wykonać tej procedura przechowywana, ci użytkownicy mogą tylko przeczyścić historia zadań, których jest właścicielem.

The SQLAgentUserRole, SQLAgentReaderRole, and SQLAgentOperatorRole fixed database roles are in the msdb database.Aby uzyskać szczegółowe informacje o ich uprawnień Zobacz SQL Server Agent Fixed Database Roles.

Przykłady

A.Usuwanie historia dla określonego zadanie

USE msdb ;
GO

EXEC dbo.sp_purge_jobhistory
    @job_name = N'NightlyBackups' ;
GO

B.Usuwanie historia dla wszystkich zadań

USE msdb ;
GO

EXEC dbo.sp_purge_jobhistory ;
GO

See Also

Reference