jobs.sp_purge_jobhistory (Pekerjaan Azure Elastic) (Transact-SQL)
Berlaku untuk: Azure SQL Database
Menghapus catatan riwayat untuk pekerjaan di layanan Azure Elastic Jobs untuk Azure SQL Database.
Prosedur tersimpan sp_purge_jobhistory
ini berbagi nama dengan objek serupa di SQL Server untuk layanan SQL Server Agent. Untuk informasi tentang versi SQL Server Agent, lihat sp_purge_jobhistory.
Sintaks
[jobs].sp_purge_jobhistory [ @job_name = ] 'job_name'
[ , [ @job_id = ] job_id ]
[ , [ @oldest_date = ] oldest_date ]
Argumen
[ @job_name = ] N'job_name'
Nama pekerjaan untuk menghapus catatan riwayat. @job_name adalah nvarchar(128), dengan default NULL
.
Baik @job_id atau @job_name harus ditentukan, tetapi keduanya tidak dapat ditentukan.
[ @job_id = ] job_id
Nomor identifikasi pekerjaan untuk rekaman yang akan dihapus. @job_id adalah uniqueidentifier, dengan default NULL
.
Baik @job_id atau @job_name harus ditentukan, tetapi keduanya tidak dapat ditentukan.
[ @oldest_date = ] oldest_date
Rekaman tertua yang dipertahankan dalam sejarah. @oldest_date adalah datetime2, dengan default NULL
. Saat @oldest_date ditentukan, sp_purge_jobhistory
hanya menghapus rekaman yang lebih lama dari nilai yang ditentukan.
Setiap kali dalam pekerjaan elastis berada di zona waktu UTC.
Mengembalikan nilai kode
0
(berhasil) atau 1
(kegagalan).
Keterangan
Riwayat pekerjaan elastis secara otomatis dihapus jika berusia lebih dari 45 hari.
Izin
Secara default, anggota peran server tetap sysadmin dapat menjalankan prosedur tersimpan ini. Hanya anggota sysadmin yang dapat menggunakan prosedur tersimpan ini untuk mengedit atribut pekerjaan yang dimiliki oleh pengguna lain.
Contoh
J. Menghapus riwayat pekerjaan lama
Contoh berikut menunjukkan cara menghapus riwayat pekerjaan sebelum tanggal tertentu.
Sambungkan ke job_database
dan jalankan perintah berikut:
--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. Menghapus pekerjaan dan semua riwayat pekerjaannya
Contoh berikut menunjukkan cara menghapus pekerjaan menggunakan jobs.sp_delete_job dan semua riwayat pekerjaan terkait.
Sambungkan ke job_database
dan jalankan perintah berikut:
--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';