ApsaraDB RDS：Tugas terjadwal (pg_cron)

Secara default, tugas terjadwal dijalankan dalam Coordinated Universal Time (UTC). Saat menyiapkan tugas, Anda harus mengonversi waktunya berdasarkan parameter TIMEZONE database Anda. Jika tugas terjadwal tidak dipicu sesuai harapan, Anda dapat menyiapkan tugas yang berjalan setiap menit untuk memeriksa ketersediaan ekstensi. Contohnya:

SELECT cron.schedule('* * * * *', 'SELECT 1;');

Tugas terjadwal disimpan di database `postgres` default. Namun, Anda dapat mengkueri tugas terjadwal tersebut dari database lain.

Ekstensi pg_cron didukung pada instans yang menjalankan ApsaraDB RDS untuk PostgreSQL 10, 11, atau 12 dengan versi mesin minor yang lebih lama dari 20201130. Namun, ekstensi tersebut telah ditingkatkan. Kami menyarankan agar Anda meningkatkan versi mesin minor ke versi terbaru. Jika Anda menggunakan pg_cron sebelum peningkatan, Anda harus membuat ulang ekstensi tersebut untuk menggunakan fitur-fitur barunya. Catatan: Saat Anda membuat ulang ekstensi, tugas terjadwal yang ada akan dihapus.

Buat ekstensi

• Instal ekstensi dari Konsol

  1. Buka halaman Instances. Di bilah navigasi atas, pilih wilayah tempat instans berada. Lalu, temukan instans tersebut dan klik ID-nya.

  2. Di panel navigasi kiri, klik Extension Management.

  3. Di halaman Extension Management > Uninstalled Extensions, temukan ekstensi pg_cron. Pilih database tempat ekstensi akan diinstal dan klik Install.

  4. Di kotak dialog, pilih Akun istimewa dan klik Install untuk menginstal ekstensi pada database tujuan.

     Status instans berubah menjadi Maintaining Instance selama proses instalasi. Ekstensi berhasil diinstal ketika status berubah menjadi Running.

• Instal ekstensi menggunakan perintah SQL

  1. Atur parameter instans. Tambahkan pg_cron ke Running Parameter Value untuk parameter shared_preload_libraries. Misalnya, ubah Running Parameter Value menjadi 'pg_stat_statements, auto_explain, pg_cron'.

  2. Gunakan Akun istimewa untuk terhubung ke database tujuan dan jalankan pernyataan SQL berikut.

     CREATE EXTENSION pg_cron;

     Catatan

     Anda dapat menjalankan SELECT * FROM pg_extension untuk melihat ekstensi yang telah diinstal.

Buat tugas terjadwal

SELECT cron.schedule('<Task Name>','<Schedule>', '<Action>');

Contoh:

-- Hapus data kedaluwarsa pada pukul 03.30 (UTC) setiap hari Sabtu. 
SELECT cron.schedule('30 3 * * 6', $$DELETE FROM events WHERE event_time < now() - interval '1 week'$$);

----------

-- Jalankan pekerjaan vacuum pada pukul 10.00 (UTC) setiap hari.
SELECT cron.schedule('0 10 * * *', 'VACUUM');

Buat tugas terjadwal di database tertentu

SELECT cron.schedule_in_database('<Task Name>', '<Schedule>', '<Action>', '<Database>');

Jika instans ApsaraDB RDS untuk PostgreSQL Anda menjalankan versi mesin minor yang lebih lama dari 20230530, gunakan perintah berikut. Jika Anda tidak menentukan database, tugas akan dijalankan di database yang ditentukan oleh parameter cron.database_name. Database default adalah postgres.

SELECT cron.schedule('<Schedule>', '<Action>', '<Database>')

Contoh:

SELECT cron.schedule_in_database('weekly-vacuum', '0 4 * * 0', 'VACUUM', 'some_other_database');

Lihat daftar tugas terjadwal

SELECT * FROM cron.job;