Udostępnij za pośrednictwem

  • Artykuł

sp_purge_jobhistory (języka Transact-SQL)

Usuwa rekordy historia zadanie.

Topic link iconKonwencje składni języka Transact-SQL

sp_purge_jobhistory 
   {   [ @job_name = ] 'job_name' | 
     | [ @job_id = ] job_id }
   [ , [ @oldest_date = ] oldest_date ]

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

W następującym przykładzie usunięto historia zadanie o nazwie NightlyBackups.

USE msdb ;
GO

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

B.Usuwanie historia dla wszystkich zadań

Uwaga

Tylko członkowie sysadmin Rola serwera i członkowie SQLAgentOperatorRole można usunąć historię dla wszystkich zadań.Kiedy sysadmin użytkownikom wykonać tej procedura przechowywana bez parametrów zadanie jest czyszczona historii dla wszystkich lokalnych i wieloserwerowych zadanie s.Kiedy SQLAgentOperatorRole użytkownikom wykonać tej procedura przechowywana bez parametrów, tylko Historia zatrudnienia dla wszystkich zadań lokalnego jest czyszczona.

W poniższym przykładzie wykonuje procedurę bez parametrów, aby usunąć wszystkie rekordy historia.

USE msdb ;
GO

EXEC dbo.sp_purge_jobhistory ;
GO