Bagikan melalui


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 (Transact-SQL).

Konvensi sintaks transact-SQL

Sintaks

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

Argumen

@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

Nomor identifikasi pekerjaan untuk rekaman yang akan dihapus. job_id adalah pengidentifikasi unik, dengan default NULL. Baik job_id atau job_name harus ditentukan, tetapi keduanya tidak dapat ditentukan.

@oldest_date

Rekaman tertua yang dipertahankan dalam sejarah. oldest_date 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 (keberhasilan) 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

Menghapus riwayat pekerjaan lama

Contoh berikut menunjukkan cara menghapus riwayat pekerjaan sebelum tanggal tertentu.

Koneksi 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

Menghapus pekerjaan dan semua riwayat pekerjaannya

Contoh berikut menunjukkan cara menghapus pekerjaan menggunakan jobs.sp_delete_job dan semua riwayat pekerjaan terkait.

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